Atari 
System 
Reference 
Manual 



Atari System Reference manual 



Written by Bob DuHamel (c)1987 

IHypertext version constructed by Ivo van Poorten 

(c)1994 

Bob Duhamel 

6915 Casselberry Way 

San Diego, C A 92119 

Atari is a registered trademark of Atari Corp. 



This manual contains highly technical information. Such information is provided for those 
who know how to use it. To understand the advanced information you are expected to know 
6502 assembly language. If you are new to programming, concentrate on the parts which 
discuss BASIC commands. 

Addresses are usually given in both hexadecimal and decimal numbers. The operating 
system equate names are given in capital letters with the address following in brackets. The 
decimal address is in parenthsis within the brackets. For example: 



DOSVEC [$000A,2 (10)] 
name hex dec 

The ",2" after the hexadecimal number means that this address requires two bytes to hold its' 
information. Any address called a "vector" uses two bytes whether noted or not. 

Control registers and some other bytes of memory are shown in the following format 



Register format 

76543210 

I I 



16318421 
2 4 2 6 



The numbers on top are the bit numbers. Bit 7 is the IVIost Significant Bit (IVISB) and bit is 
the Least Significant bit (LSB). The numbers on the bottom are the bit weights. These are 
useful when changing memory with decimal numbers, as you would in BASIC. For example, 
to set bit 4 of a register to 1 , without changing any other bits you would add 16 to the decimal 
number already in the register. To reset the same bit to 0, you would subtract 16 from the 
number in the register. This is exactly what the command GRAPHICS 8+16 does. It sets bits 
3 and 4 of a graphics mode control register. 

MSB and LSB may also mean Most Significant Byte or Least Significant Byte, depending on 
context. 



Table of contents 

1 . The Central Input/Output Utility (CIO) 

2. The Disk Operating System (DOS) 

3. Using the DOS 2 Utilities (DUP.SYS) 

4. The Cassette Handler (C:) 

5. The Keyboard Handler (K:) 

6. The Printer Handler (P:) 

7. The Screen Editor (E:) 

8. The Display Handler (S:) 

9. The Resident Disk Handler 

10. System Interrupts 

1 1 . The Floating Point Arithmetic Package 

1 2. Boot Software Formats 

13. The Serial Input/Output Interface (SIO) 

14. The Hardware Chips 

15. Display Lists 

16. Player and Missile Graphics 

17. Sound 

1 8. The Joystick Ports 

19. Misc.. 

20. The XL and XE Models 



A. Hardware Registers 

B. Operating System Equates 

C. Memory Use 



Ivo van Poorten (ipoorten(2)cs. vu.nl) 



CHAPTER 1 



The central Input/Output utility (CIO) 



The ATARI computer uses a very easy-to-use input and output system called the Central 
Input/Output utility, or CIO. Nearly all input or output passes through this utility. 

CIO uses eight "channels" as paths for I/O. There are not really separate channels for I/O but 
the computer acts as if there were. Each channel is controlled by a 1 6 byte block of memory 
called an Input/Output Control Block or IOCS. The channels are used by putting the proper 
numbers in the proper lOCB bytes then jumping to the CIO routine. In BASIC, complete I/O 
operations can be as easy as typing a command such as LPRINT. In this case BASIC does 
all the work for you. 



THE CIO CHANNELS 

There are eight CIO channels, numbered from to 7. In BASIC some channels are reserved 
for BASIC'S use. 



BASIC CIO channel assignments 

Channel Permanently assigned to the screen editor 
5 Used for graphics commands 
7 Used for the Cassette, disk and printer 



Channels 6 and 7 are free to use when they are not being used by BASIC. With machine 
language, all of the channels are available to the programmer. 



THE lOCB STRUCTURE 

The lOCB for channel zero starts at address $0340 (decimal 832). This is the only address 
you need to know. Indexing from this address is used to find all of the other bytes. Below are 
the names and uses of the lOCB bytes. 

lOCB bytes and uses: 
ADDRESS NAME EXPLANATION 



$0340 ICHID handler Identifier 

$0341 ICDNO device number (disk) 

$0342 ICCOM command 

$0343 ICSTA status 



$0344 


ICBAL 


$0345 


ICBAH 


$0346 


ICPTL 


$0347 


ICPTH 


$0348 


ICBLL 


$0349 


ICBLH 


$034A 


ICAXl 


$034B 


ICAX2 


$034C 


ICAX3 


$034D 


ICAX4 


$034E 


ICAX5 


$034F 


ICAX6 



buffer address (low byte) 
buffer address (high byte) 
address of put byte 

routine (used by BASIC) 
buffer length (low byte) 
buffer length (high byte) 
auxiliary information 

the remaining auxiliary 
bytes are rarely used 



ICHID 

When a channel is open, the handler I.D. contains an index to the handler table. The handler 
table (to be discussed later) holds the address of the device handling routines. When the 
channel is closed ICHID contains $FF. 

ICDNO 

The device number is used to distinguish between multiple devices with the same name, 
such as disk drives. 



ICCOM 



The command byte tells CIO what operation to perform. 



CIO command codes 



HEX 



DEC 



+Open 


$03 


3 


+close 


$0C 


12 


get 


$07 


7 


put 


$09 


11 


input 


$05 


5 


print 


$09 


9 


+status 






request 


$0D 


13 


♦special 


>$0D 


>13 



+ command may be made to a closed channel 
* device specific commands 



ICSTA 

The status byte contains an error code if something goes wrong, if bit 7 is there have been 
no errors. 

ICBAL and ICBAH 

Before a channel is opened, the buffer address bytes are set point to the block of memory 
which contains the name of the device the channel is to be opened to. Before actual input or 
output these bytes are set to point to the block of memory where the I/O data is stored or is 
to be stored. 

ICPTL and ICPTH 

The put routine pointer is set by CIO to point to the handlers' put-byte routine. When the 
channel is closed the pointer points to the lOCB-closed routine. This pointer is only used by 
BASIC. 

ICBLL and ICBLH 

The buffer length bytes show the number of bytes in the block of memory used to store the 
input or output data. (See ICBAL and ICBAH.) If the amount of data read during an input 
operation is less than the length of the buffer, the number of bytes actually read will be put in 
ICBLL and ICBLH by CIO. 

ICAX1 through ICAX6 

The auxiliary information bytes are used to give CIO or the device any special information 
needed. 



OPENNING A CIO CHANNEL 

Before using a CIO channel it must be assigned to an I/O device. In machine language you 
start by putting the channel number in the four high bits of the 6502 X register (X = $30 for 
channel three). Next you place the necessary codes (parameters) into lOCB indexed by X. 
The X register will cause the numbers to be offset in memory by 16 times the channel 
number. This puts the numbers into the correct lOCB instead of lOCB 0. Below are the 
parameters used to open a channel. 



Channel-open parameters: 
ICCOM open code 



ICBAL address of device name 
ICBAH in memory 

ICAXl direction code 

ICAX2 zero 



The direction code byte in ICAXl takes on the following format: 

ICAXl format for opening a channel 

76543210 

ICAXl I W R I 

8 4 2 1 

W 1 = open for output (write) 
R 1 = open for input (read) 



ICAXl may have the following data 



CIO direction codes 

HEX DEC operation 

$04 4 input 
$08 8 output 

$0C 12 input and output (cannot change the length 
of a disk file) 



ICBAL and ICBAH point to the device name stored in memory. The device and file name 
must be followed by or $9B (decimal 155). 

Once the parameters are set, jumping (JSR) to the CIO vector 

(CIOV) at address $E456 (58454) will cause the channel to be opened. In the following 
example a basic knowledge of assembly language is assumed. 



Routine to open channel 1 to the keyboard: 

ICHID = $0340 

ICCOM = ICHID+2 

ICAXl = ICHID+10 

ICAX2 = ICHID+11 

lOCBl = $10 channel in four high bits 

CIOV = $E456 

OPEN = $03 

OREAD = $04 ;open for input 

ERROR = (address of error handling routine) 



START LDX lOCBl 

LDA OPEN 

STA ICCOM, X 

LDA <NAME 

STA ICBAL,X 

LDA >NAME 

STA ICBAH,X 

LDA OREAD 

STA ICAX1,X 

LDA #0 

STA ICAX2,X 

JSR CIOV 

BPL OK 

JMP ERROR 

NAME .BYTE "K:",$9B 

OK (program continues here) 



To open a CIO channel in BASIC the OPEN command is used. 

BASIC OPEN command format: 

OPEN tchannel, auxl , aux2 , device : file name 



auxl = direction code 
aux2 = special code 



To open channel 1 to the keyboard in BASIC Type: 



OPEN #1, 4, 0, "K: ' 



The third parameter, aux2, is a rarely used special parameter. One use is to keep the screen 
from erasing when changing graphics modes. 

The fourth parameter is the device to open the channel to. It may be either a string in quotes 
or a string variable. 



CIO device names 



C cassette recorder 
''D disk drive 
E screen editor 



K Keyboard 

P printer 

^R RS 232 I/O port 

S screen handler 



Uses a non-resident handler loaded by the device at 
power-up . 



The device name must usually be followed by a colon. With the disk drive a file name is 
expected after the device name. The screen handler is used for graphics. The screen editor 
uses both the keyboard handler and the screen handler to work between the keyboard and 
screen. 



USING AN OPEN CHANNEL 

Once a channel is opened to a device you have several options: 

INPUT: (ICCOM = $05) 



The computer reads data from the device until a carriage-return is read (decimal number 
155, hex $9B) or the end of the file (EOF) is reached. A carriage return is also known as an 
End-Of-Line or EOL. The lOCB input parameters are: 



lOCB input parameters: 

ICCOM get record code 

ICBAL address of buffer to 

ICBAH store the data in 

ICBLL length of the data 

ICALH buffer 



The following routine demonstrates the input command in assembly language. Some of the 
equates are in the channel openning example above. 



Input routine: 

GETREC = $05 

BUFF = (address to store data at) 

BUFLEN = (number of bytes available at storage address) 

LDX lOCBl 
LDA GETREC 
STA ICCOM, X 



LDA < BUFF 

STA ICBAL,X 

LDA > BUFF 

STA ICBAH,X 

LDA < BUFLEN 

STA ICBLL,X 

LDA > BUFLEN 

STA ICBLH,X 

JSR CIOV 

BPL 0K2 

JMP ERROR 

0K2 (continues if no errors) 



If the data retrieved is shorter than the prepared buffer, the number of bytes actually read wil 
be put into ICBLL and ICBLH. 

In BASIC, the INPUT command is used. 



BASIC INPUT command format: 
INPUT #channel, string variable 

or 
INPUT #channel, arithmetic variable 

For example : 
INPUT #1,IN$ 



The above commands will cause the data from the device to be put into the specified buffer 
(IN$ in the BASIC example) until an EOL is reached. If the INPUT statement is used again, 
without closing the channel, the computer will get more data from the device until another 
EOL is read or the end of the file is reached. The new data will write over the old data in the 
input string or buffer. If an arithmetic variable is used, only numbers can be input. 



PRINT: (ICCOM = $09) 



In assembly language the print command is identical to the input command. The only 
difference is that the PUTREC code ($09) is stored in ICCOM. Of course the buffer bytes of 
the lOCB then specify the block of memory to be output from rather than input to. With the 
print command, EOLs within the string or buffer are ignored but an EOL is placed at the end 
of the data when sent to the device. 

In BASIC, the PRINT command is used like INPUT except you want to use a semicolon 
instead of a comma to separate parameters. For example: 



PRINT #1;0UT$ 



PRINT #1; "HELLO" 



If you use a comma, ten space characters will be sent before the string. 

If the print command is used again, without closing the channel, the new data will be 
appended to the end of the data previously sent. Old data will not be written over. 



GET: (ICCOM = $07) 



In BASIC this command inputs a single byte of data from the device. EOLs are ignored. In 
BASIC, GET is used like INPUT except an arithmetic variable must be used. For example: 



GET #1,IN 



If the get command is used again the next byte from the device will be read. If the end of a 
file is reached an error will occur. 

There is no command in BASIC to input an entire file without stopping at each EOL. If you 
wish to ignore EOLs while reading a file to a string, you must use the GET command. Each 
byte of data is then put into the string by the program. 



EXAMPLE: 

10 OPEN #1, 4, 0, "D:TEST" 

20 TRAP 60: REM GOES TO LINE 60 WHEN END OF FILE ERROR OCCURS 

30 GET #1, IN 

40 IN$ (LEN (IN$) +1) =CHR$ (IN) 

50 GOTO 30 

60 CLOSE #1 



In assembly language, the get command can be used to get any number of bytes from the 
device. It works just as INPUT does except EOLs are ignored. 



lOCB get-byte parameters: 

ICCOM get-character (single byte) code 

ICBAL \ 

ICBAH same as in input 

ICBLL 



10 



ICBAH / 



Other than the ICCOM code (GETCHR = $07) this command is identical to the input 
command. 



PUT: (ICCOM = $0B) 



In BASIC, PUT is the opposite of GET. It outputs a single byte from a variable to the device. 
PUT is used the same as GET. For example: 



PUT #1,0UT 



In assembly language, the command byte of the lOCB is loaded with the put-character code 
(PUTCHR = $08). Otherwise the PUT command is identical to GET. 



CLOSING A CHANNEL 

Closing a channel frees it for use by another device or for changing parameters. In assembly 
language the close code is put into the command byte of the IOCS then the CIOV call is 
made. 



lOCB close command: 

CLOSE = $0C 

LDX lOCBl 

LDA CLOSE 

STA ICCOM, X 

JSR CIOV 

In BASIC, use the CLOSE command followed by the channel number. 

CLOSE #1 

With the disk drive, the file name is not put into the directory until the channel is closed. 
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THE DEVICE TABLE 

CIO uses a jump table located at $031 A (794). When a CIO call is made, CIO searches the 
table for the one-byte device name. The two bytes following the device name contain the 
address of the device handler's vector table. CIO searches the device table from the end, 
$033D (829) to the beginning. This way, if a custom handler has ben substituted for a 
resident handler, the custom handler will be found first, (custom handlers cannot be inserted 
directly in the place of resident handlers in the device table.) 

Each handler has its' own vector table. This vector table is 16 bytes long. The two-byte 
vectors point to the various handler routines. The vectors are stored in the vector table in the 
following order: 



Handler vector table order 

open 

close 

get byte 

put byte 

get Stat 

special 

JMP init code (3 bytes) 



The open routine should validate the ICAX parameters and check for illegal commands. 

The close routine should send any remaining data in the buffer to the device, mark the 
End-Of-File and update any directories, etc. 

The get byte routine should get a byte from the device or the handler buffer and put it in the 
6502 A register. Handlers with long timouts must monitor the break key flag and put a $80 in 
the 6502 Y register if the [BREAK] key is pressed. 

The put byte routine should send the byte in the 6502 A register to the device or handler 
buffer. If the buffer fills, it should be sent to the device. BASIC can call the put byte routine 
without using CIO. 

The get status routine may get 4 bytes of status information from the device and put them in 
DVSTAT [$02 EA] to DVSTAT+3. 

For special commands the handler must examine the command byte and find the proper 
routine entry point. 

In all cases the status (error code) of the operation should be put in the 6502 Y register. 

To be compatible with all versions of the operating system, the handler must redirect DOSINI 
[$000C,2 (12)] for initialization upon reset. This initialization must restore the vectors in the 
handler vector table and jump to the origional DOSINI vector. 
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SPECIAL COMMANDS 

Some devices have special CIO commands. These are known as device specific commands. 
In assembly language these commands are executed just as any other CIO command is. In 
BASIC the XIO command is used. An example of the XIO command is: 



XIO command code tchannel, auxl, aux2, device : file name 



To open a channel with the XIO command instead of the OPEN command use: 



XIO 3 #1, 4, 0, "K: " 



Note that the above command is identical to the OPEN command except "XIO 3" is used 
instead of "OPEN". Also note that $03 is the lOCB open code for ICCOM. 



Useful database variables and OS equates 



DOSINI 


$000C,2 


(12) 


BRKKEY 


$0011 


(17) 


ICHID 


$0340 


(832) 


ICDNO 


$0341 


(833) 


ICCOM 


$0342 


(834) 


ICSTA 


$0343 


(835) 


ICBAL 


$0344 


(836) 


ICBAH 


$0345 


(837) 


ICPTL 


$0346 


(838) 


ICPTH 


$0347 


(839) 


ICBLL 


$0348 


(840) 


ICBLH 


$0349 


(841) 


ICAXl 


$034A 


(842) 


ICAX2 


$034B 


(843) 


HATABS 


$031A, 16 


(794) 


CIOV 


$E456 


(58454) 



initialization vector 
break key flag 
start of lOCBs 



device handler table 
CIO entry vector 



Go to Table of contents 
Go to chapter 2 
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CHAPTER 2 



The Disk operating System (D:) 



The disk operating system program (DOS) is also called the file management system (FMS). 
DOS is not a permanent part of the computer, it is loaded in upon power-up if a disk drive is 
attached to the computer. 

When the computer is turned on, one of the first things it does is send a request to the disk 
drive to load DOS into the computer. This startup operation is called booting. The word boot 
is short for bootstrapping — the start-up process of early computers. The term comes from 
"lifting one's self by one's boot straps". 

Anytime the disk boots, the computer tries to read a program starting at sector 1 and 
continuing in sequence. If the disk has DOS on it, the first three sectors, called the boot 
record, have a program which loads the DOS. SYS file. If there is no DOS. SYS file on the 
disk the computer will display: 



BOOT ERROR 

BOOT ERROR 

BOOT ERROR 

BOOT ERROR 

BOOT ERROR 

BOOT ERROR 
(etc.) 



When a disk is formatted, the drive read/write head passes over the entire disk and puts 
magnetic marks on it. These marks divide the disk into 32 concentric tracks. With DOS 2.0 
each track is divided into 18 sectors, each holding 128 bytes of data. With DOS 2.5 there are 
32 sectors per track giving a total of 1 ,024 sectors. 

Each sector on the disk is marked with a reference number from 1 to 720. Unfortunately, the 
writers of DOS 2.0 didn't know this so they wrote the DOS to use sectors numbered from to 
719. As a result, DOS 2.0 cannot access sector 720. The designers of the disk drive were 
the guilty party in this case. It is normal to number from in computers. With DOS 2.5, 
sectors 720 - 1 ,024 can be accessed normally. 

Sector 720 can be accessed using the computer's resident disk handler. Some software 
writers use sector 720 to hide special information to make their programs difficult to copy. 
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DOS 2 SECTOR ASSIGNMENTS 

Sectors 1 through 3 are called the boot record. They contain a program which loads the 
DOS. SYS file into memory. 

Sector 360 is called the Volume Table of Contents or VTOC. The main purpose of the VTOC 
is to keep track of what sectors are occupied. Bytes 3 and 4 of the VTOC tell how many 
sectors are available. Starting at byte 10 is the Volume Bit Map. Each byte in the VBM tells 
the status of eight sectors. If a bit is a 1 the sector is available. If a bit is a the sector is 
occupied. 

Sectors 361 through 368 contain the disk directory. Each directory sector holds eight file 
names. The first byte of a file name is called the flag byte. It tells the status of that file. 



Directory flag byte. 
76543210 
I flag byte i 



its: 


7 


1 


= file 


deleted 




6 


1 


= file 


in use 




5 


1 


= file 


locked 







1 


= open 


for output 



The next two bytes tell how many sectors are in the file. The two bytes after them tell the 
starting sector of the file. The last 1 1 bytes contain the file name. 

Sector 720 cannot be accessed with DOS 2.0. 

The boot record, VTOC, directory and sector 720 use 13 sectors. This leaves 707 sectors for 
storing files with DOS 2.0. 

Each file sector has 125 bytes of data. The last three bytes tell how many bytes of the sector 
are used, what directory entry the sector belongs to and which sector is next in the file. 



File sector structure 

76543210 
I data I byte 
I bytes I byte 124 
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I Dir. No. |hi | byte 125 
I forward pointer] byte 126 
IS I byte count i byte 127 



hi = high 2 bits of forward pointer 
S = Short sector flag. 1 = short sector (End Of File) 



If the directory number does not match the order of the file name in the directory, an error 
167 (file number mismatch) will occur. 

As a file is written to an empty disk it is put in consecutive sectors, 1 25 bytes at a time. After 
the file is written, the VTOC and directory are updated. When new files are written they also 
use consecutive sectors. 

When a file is deleted the status bit of the directory is changed to show that the file has been 
deleted. DOS then tracks the file, sector by sector, to find what sectors are used. Finally the 
VTOC is updated to show that the deleted file's sectors are available for new files. The file is 
not erased from the disk; only the VTOC and directory are changed. 

When a file is deleted, an "island" of free sectors may be left on the disk. When a new file is 
then written to the disk it will first use these new free sectors. When the island is used up, 
DOS will skip over the occupied sectors to the next free sector. This is the reason for the 
sector link. A file can end up with it's sectors scattered all over a disk. It can be complicated 
but it's efficient. 



DISK FILE STRUCTURE 

The first few bytes of a file may tell DOS or another program what kind of file it is. These 
information bytes are called a header. 

A text file is any file which has no header. A listed BASIC program is a type of text file. A 
letter from a word processor is another. 

A binary load file is a file intended to load to a specific address in memory. The first two 
bytes of a binary load file are decimal 255. The next two bytes hold the address at which the 
file is to load. The last two header bytes tell the ending address for the file. If the file is a 
program and is to run automatically, the initialization and run address are appended to the 
end of the file. 



binary load file header 
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Decimal Hexadecimal 

255 identifier FF 

255 FF 

start 00 

7 07 
15 end FF 

8 08 



The above file would load at address $0700 (1792 decimal) and end at address $08FF 
(2063). If a binary load file has initialization and run address appended to it they take on the 
following format: 



init and run taller 

CHR Decimal Hexadecimal 



init address format 



[b] 226 identifier E2 
I 2 02 

[c] 227 E3 
I 2 02 

n address nn 



run address format 



[diamond] 224 identifier EO 

I 2 02 

[a] 225 El 

I 2 02 

n address nn 

n nn 

[ ]=inverse video 



A program which doesn't need special initialization can be run at the init address. Otherwise, 
an RTS instruction is expected at the end of the initialization section. The computer will then 
jump to the run address if specified. 
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INSIDE THE COMPUTER 

DOS uses the computer's CIO utility. When a DOS disk is booted a non-resident handler is 
loaded into memory. A new handler name, D, is then added to the handler table. When CIO 
is called with a device name of D: or Dn:, CIO will search the handler table for that device 
name. If the 'D' is found, the next two bytes in the table point to the DOS entry address. 



DOS FILE NAME CONVENTIONS 

DOS is unique among CIO handlers in that it requires an eight character file name to follow 
the device name. This file name may be followed by a period and then a three character 
extender. 



EXAMPLES: D:TEST, D2:FIREMAN, D : VENTURE . EXE, D : CHAPTER. 00 1 



The D2: is used for drive number two if present. 

The file name must use upper-case letters or numbers. The first character must always be a 
letter. 



WILD CARDS 

The characters * and ? may be used as wild cards. * means any combination of characters 
and ? means any single character. 



EXAMPLES: D:P* any file beginning with P and 

without an extender 
D:*.EXE any file with the extender .EXE 
D : * . * any file . 

D:F?REMAN one unknown character, 

FIREMAN or FOREMAN will match 



Wild cards can only be used to load, delete, lock and unlock files. 

When loading a file using wild cards, only the first matching file will be loaded. 

When renaming a file, both the new and old names are expected after the device name. 

EXAMPLE : D : OLDNAME . BAS, NEWNAME . BAS 
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To format a disk, only the device name (D: or Dn:) is needed. 



USING DOS 

When a CIO channel is opened to the disk drive it must actually be opened to a specific file 
on the disk. The device name in the open command must be followed by a file name. 

When a channel is opened to the disk, two special parameters may be used in ICAX1 . 



ICAXl for disk open: 
76543210 
I W R D A| 



D 1 = open to read the directory instead of a file 
A 1 = append data to the end of the file 



This gives the following extra ICAXl options. 



Disk specific ICAXl options: 



HEX DEC 

$06 6 open to read directory 

$09 9 output, append to the end of an 

existing file 



READING THE DIRECTORY 

When the directory is read, each file name is treated as if it were followed by an EOL. A loop 
must be used to read all of the file names in the directory. The last entry read is the free 
sector count. After it is read, another read operation will result in an End-Of-File error. 

The disk drive has a number of device specific commands other than the regular CIO 
commands. From BASIC the XIO command is used to access these commands. The XIO 
command allows you to directly load the lOCBs from BASIC. Each parameter of the XIO 
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command places values in certain bytes of an lOCB. 



XIO command format : 



XIO command channel, auxl , aux2 , device : file name 



Note that the parameters resemble the BASIC OPEN command. The BASIC OPEN 
command is identical to it's equivalent XIO command. 



XIO commands specific to the disk drive. 

RENAME XIO $2 (32) 

DELETE XIO $21 (33) 

LOCK XIO $23 (35) 

UNLOCK XIO $24 (36) 

POINT XIO $25 (37) 

NOTE XIO $26 (38) 

FORMAT XIO $FE (254) 



EXAMPLES : 

XIO 33 #1, 0, 0, "D: JUNK" = delete file named D : JUNK 

XIO 32 #1, 0, 0, "D:OLD,NEW" = change name of D:OLD to D:NEW 



NOTE and POINT can also be used directly from BASIC. NOTE finds the current position of 
the read/write head on the disk. POINT moves the read/write head to the desired position. 



USING NOTE AND POINT 

The command format for NOTE and POINT is as follows: 



NOTE \ 

channel, sector, byte 
POINT/ 



EXAMPLE: 



NOTE #1, SECT, BYTE 
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BASIC requires the sector and byte parameters in both commands to be variables. Fixed 
numbers cannot be used. If you try to do a POINT to a sector outside the file the channel is 
open to, a point error will occur. Care may need to be taken to be sure the file being 
accessed is in contiguous sectors on the disk. If it is not, it will be difficult to know where to 
do points to. 

One use of NOTE is to use the command immediately after opening a channel to a disk file. 
After the NOTE command, the parameter variables contain the coordinates of the first byte of 
the file. They can then be used as a reference for the POINT command. 

In assembly language, ICAX3 and ICAX4 are used for the sector number (lsb,msb). ICAX5 is 
used for the byte number. 



STATUS REQUEST 

If the status request command is used, one of the following values will be found in ICSTA 
and the 6502 Y register. 



HEX DEC 



$01 


1 


OK 


$A7 


157 


file locked 


$AA 


170 


file not found 



Go to chapter 1 
Go to chapter 3 





CHAPTER 3 

Using the DOS 2 utilities (DUP.SYS) 



If you boot a DOS disk with no cartridge in the slot or with BASIC disabled (by holding the 
OPTION key), DOS will try to load the file named DUP.SYS. This is the disk utility file. When 
using BASIC, typing DOS [RETURN] will load the DUP.SYS file. When the utilities are 
loaded the menu will appear on the screen. 
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THE DOS UTILITIES MENU 



DISK OPERATING SYSTEM II VERSION 2 . OS 
COPYRIGHT 198 ATARI 



A. 


DISK DIRECTORY 


I. 


FORMAT DISK 


B. 


RUN CARTRIDGE 


J. 


DUPLICATE DISK 


C. 


COPY FILE 


K. 


BINARY SAVE 


D. 


DELETE FILE (S) 


L. 


BINARY LOAD 


E. 


RENAME FILE 


M. 


RUN AT ADDRESS 


F. 


LOCK FILE 


N. 


CREATE MEM.SAV 


G. 


UNLOCK FILE 


0. 


DUPLICATE DISK 


H. 


WRITE DOS FILES 







SELECT ITEM OR [RETURN] FOR MENU 



[A] DIRECTORY 

After pressing [A] [RETURN] you will get the prompt: 

DIRECTORY— SEARCH SPEC,LIST FILE? 

If you want to see the entire directory just press [RETURN] again. If you wish, you may type 
in a specific file name (D: is optional) or wild cards to search for. If you specify a search spec 
only matching files will be displayed. 

If you want, you can have the directory sent to another device. To do this type a comma and 
the device name. For example, if you type ,P: the directory will be sent to the printer. 



[B] RUN CARTRIDGE 

If a cartridge was inserted or BASIC was not disabled when the computer was turned on, [B] 
[RETURN] will run that cartridge or BASIC. 



[C] COPY FILE 

This option will copy a file to another part of the same disk (with a different file name) or copy 
from one disk drive to another. When you press [C] [RETURN] you will be given the prompt: 
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COPY— FROM, TO 

Type the devices and file names separated by a comma. 

EXAMPLES: 

FOREMAN, FIREMAN 

or 

D1:TEST,D2:TEST 

The first example will copy to the same disk. The second example will copy from disk drive 
one to disk drive two. 

If you want to have the first file appended to the end of the second file type /A after the file 
names. 

EXAMPLE: 

RUNMENU.EXE,AUTORUN.SYS/A 

If the files are binary load files, this will cause both files to be saved as one file. When the 
load command is used they will both be loaded and run. 



[D] DELETE FILE(S) 

After pressing [D] [RETURN] you will get the prompt: 

DELETE FILE SPEC 

After typing the file name you will be asked to confirm the file to delete. 

DELETE FILE SPEC DELETE-D1 :JUNK ARE YOU SURE? 

Press [Y] if the correct file is displayed. If you use wild cards you will be asked to confirm 
each matching file. 

[E] RENAME 

Upon typing [E] [RETURN] you will be given the prompt: 
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RENAME-GIVE OLD NAME,NEW 

Type the file name you want to change and the new name separated by a comma. 

EXAMPLE: 

COLT,HORSE 

WARNING! Do not rename a file to a name which already exists on the disk. You will end up 
with a duplicate file name and will not be able to access one of them. Attempting to rename 
or delete one of them will rename or delete both. The only way to fix a duplicate file name is 
with a sector editor or other special utility. 



[F] LOCK FILE 

A locked file cannot be written to, renamed or deleted. To lock a file type [F] [RETURN]. You 
will get the prompt: 

WHAT FILE TO LOCK? 

Type the file name you want to lock. Wild cards will cause all matching files to be locked. 



[G] UNLOCK FILE 

Used the same as lock. 



[H] WRITE DOS FILES 

This option will write the DOS.SYS and DUP.SYS files to a formatted disk. When you type 
[H] [RETURN] you will receive the prompt: 

DRIVE TO WRITE DOS FILES TO? 

Type the number of the drive. If the drive contains a formatted disk the dos files will be 
written to it. 
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[I] FORMAT DISK 

This option formats a new disk or erases a disk with files on it. Typing [I] [RETURN] will get 
you the prompt: 

WHICH DRIVE TO FORMAT 

Be sure you have the correct disk in the proper drive then type the drive number. It is 
impossible to recover files on a disk formatted by accident. 

While the disk is being formatted the drive will check to be sure the disk is formatted 
correctly. If not, the drive attempt to format the disk again. If the disk is defective the drive wil 
not finish the formatting process. 



[J] DUPLICATE DISK 

This option will copy an entire disk except for sectors listed as free in the VTOC. Some 
programs are copy-proofed by changing the VTOC to show that some occupied sectors are 
empty. For such disks, a program which copies the entire disk is needed. 

When you press [J] [RETURN] you will be given the prompt: 

DUP DISK— SOURCE,DEST DRIVES? 

If you are using only one disk drive, type 1,1. If you have only one drive you will be told when 
to swap disks. 



[K] BINARY SAVE 

This option saves a block of memory as a binary load file. When you type [K] [RETURN] you 
will be given the prompt: 

SAVE-GIVE FILE,START,END(,INIT,RUN) 

Type the desired file name and a comma. Now type the start and end addresses of the 
memory block to be saved, in hexadecimal numbers, separated by commas. If the file is a 
program which is to automatically run when loaded, give the initialization address, if needed, 
then the run address. 

EXAMPLE: 

CHASE. EXE,0700,09FF„0700 
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This will save the block of memory from address 0700 to 09FF. The program is not initialized 
before running so there is no address typed after the third comma. When the program is 
loaded the computer will jump to address 0700, as specified in the last parameter, to run the 
program. 



[L] BINARY LOAD 

To load a binary file type [L] [RETURN]. You will get the Prompt: 

LOAD FROM WHAT FILE? 

Type the file name and the file will be loaded. If wild cards are used, only the first matching 
file will be loaded. 



[M] RUN AT ADDRESS 

Typing [M] [RETURN] will get the prompt: 

RUN FROM WHAT ADDRESS? 

Type the hexadecimal address of the program you want to run. 



[N] CREATE MEM.SAV 

A MEM.SAV file is used by BASIC and some other programs to save the part of memory 
which the DUP.SYS file loads into. If there is no MEM.SAV file on the disk when you go to 
the DOS utilities, you will loose that part of memory. With BASIC you will loose your program. 

When you type [N] [RETURN] you will get the prompt: 

TYPE Y TO CREATE MEM.SAV 

Typing [Y] [RETURN] will create a MEM.SAV file on the disk in drive one. 



[O] DUPLICATE FILE 

This option is used to copy a file from one disk to another, using only one disk drive. When 

26 



you type [O] [RETURN] you will get the prompt: 

NAME OF FILE TO MOVE? 

If you use wild cards you will be asked to swap disks for each matching file. 

DOS 2.5 also has option: 



[P] FORMAT SINGLE 

DOS 2.5 normally formats disks to use "enhanced" density. This option will format a disk in 
single density for use with the 810 drive. 

DOS 2.5 also has some special utilities on the master disk. Use the binary load option to run 
them. 

RAMDISK.SYS 

This program will cause the extra bank of memory in the 130XE to act like a disk drive 
(called D8:). If this program is on the disk it will automatically run. It need not be renamed to 
AUTORUN.SYS. 

COPY32.COM 

Copies DOS 3 files to DOS 2. 

DISKFIX.COM 

Can make certain "repairs" to a disk, such as restoring deleted files. 

SETUP.COM 

Used to change the default configuration of DOS. 

AUTORUN.SYS (DOS 2.0 and 2.5) 

This program is needed to operate the RS-232 ports on the 850 interface. If you don't want 
this program to automatically load when you boot with the master disk, rename the file to 
RS232. 
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SPECIAL DOS INFORMATION 

When DOS is in memory, changes can be made to the DOS program. These changes can 
be made by poking the changes into memory. If you want to make the changes permanent, 
you can type DOS [RETURN] to load the utilities. From the utilities menu you can use the 
write DOS files option to save the changes on disk. Some of the useful changes you can 
make follow. 

POKE 1913,80 

This turns off the write verify and speeds up disk writing. 

POKE 1913,87 

This turns write verify on 

POKE 5903,42 
POKE 5904,46 
POKE 5905,82 
POKE 5906,85 
POKE 5907,78 
POKE 5908,155 

This causes any binary file with the extender .RUN to be loaded automatically when the 
computer is turned on. 

POKE 5903,65 
POKE 5904,85 
POKE 5905,84 
POKE 5906,79 
POKE 5907,82 
POKE 5908,85 

This returns the DOS to normal. Automatically loading files named AUTORUN.SYS. 

DOS 2.0 DOS 2.5 

POKE 3772,255 
POKE 3818,64 POKE 3774,64 
POKE 3822,123 POKE 3778,123 

This will cause DOS to accept lower-case as well as upper-case letters in file names. It wil 
also now accept @,[,\,],'^ and _ . 



POKE 3772,223 
POKE 3818,65 POKE 3774,65 
POKE 3822,91 POKE 3778,91 
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This will change DOS back to normal, accepting only upper-case letters and numbers. 



Go to chapter 2 
Go to chapter 4 





CHAPTER 4 



The cassette handler (C:) 



The cassette handler sends data to the cassette recorder in blocks of 1 28 bytes each. The 
blocks are sent in the following format: 



Cassette record format 



01010101 

01010101 

control byte 

128 
data 
bytes 

checksum 



speed measurement bytes 



handled by SIO 



The control byte may have one of the following values. 

$FC (252) record is full. 

$FA (250) partly full, next record is EOF. 

$FE (254) EOF record, data section is all zeroes. 

The cassette handler has two modes of operation. The first mode uses only a short gap 
between records. It is called the no IRG (interrecord gaps) mode. The second mode uses 
longer gaps between records and is called the IRG mode. In the IRG mode the computer 
may stop the cassette recorder between records for processing data. 

When a channel is opened to the cassette recorder, bit 7 of ICAUX2 may be set to 1 (ICAX2 
= $80 (128)). This will cause the cassette to use the no IRG mode. 
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A cassette file starts with a 20 second mark tone. This tone is followed by the file records 
with 128 data bytes each. The final record is an End-Of-File record. 

The cassette is a straight-forward read/write device. There are no special functions other 
than those common to other CIO devices. 

The cassette motor is controlled by one of the controller port control registers. If bit 3 of 
PACTL [$D302 (54018)] is then the cassette motor is on. The following BASIC commands 
will turn the cassette motor on and off. 



Cassette motor control. 

POKE 54018, PEEK (54018) -8 motor on 
POKE 54018,PEEK(54018) +8 motor off 

Useful data base variables and OS equates 



PACTL $D302 (54018) : port A control register, bit 4 

controls cassette motor 



CHAPTER 5 

The keyboard handler (K:) 



The keyboard is a read only device and therefore the keyboard handler has no output 
functions. 

The keyboard handler reads the keys as ATASCII codes. Each key is represented by one 
byte of data. Therefore, each time a key is pressed the data is treated as a byte of data just 
as data from any other device is. The only difference is that the computer must wait for the 
operator to press the keys as it reads the data. 

Whenever a key is pressed an IRQ interrupt is generated by the keyboard reading hardware. 
The internal code (not ATASCII) for the key just pressed is then stored in CH [$02FC (764)]. 
The code is then compared with the prior key code in CHI [$02F2 (754)]. If the code in CHI 
is different from the code in CH, the key is accepted. The code is then converted to ATASCII, 
and placed in the database variable ATACHR [$02FB (763)]. On XL and XE models, 
KEYDEF [$0079,2 (121)] points to the key-code-to-ATASCII conversion table. (This 
address is used by the the screen handler in 400/800 models). 

If the code in CHI is the same as the code in CH, the new key code will not be accepted 
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unless the key debounce timer, KEYDEL [$02F1 (753)] is 0. 

When CIO is told to do an input operation from the keyboard, CH is checked to see if a key 
has been pressed. If CIO finds $FF (255) in CH, it waits until a key is pressed. If CH is not 
$FF, a key has been pressed and the AT ASCII code for that key is taken from ATACHR. CH 
is then set to $FF. 

The data in CH is in the following format. 



Key code format : 
76543210 
ICISI key code | 



C 1 = [CTRL] key is pressed 
S 1 = [SHIFT] key is pressed 

Anytime a key is pressed, CH is loaded with the key code. CH will hold the code until the 
computer is commanded to read the keyboard. Sometimes the computer will read a key 
which was pressed long ago. If you want to prevent this, load CH with $FF before reading 
the keyboard. (In BASIC use POKE 764,255.) This will clear out any old key pressings. 



Special function keys 

[CTRL] [1] screen output start/stop 

[CTRL] [2] BELL 

[CTRL] [3] Generates End-Of-File status 

[/l\] 

or 

[/] inverse video toggle 

[CAPS LOWER] sets lower case 

[CTRL] [CAPS] sets CTRL lock 

[SHIFT] [CAPS] sets caps lock 



KEYBOARD REPEAT DELAY AND RATE CONTROL 

On the XL and XE, KRPDEL [$02D9 (729)] determines the delay before the key repeat 
begins. The value of this byte is the number of vertical blanks (1/60th second each) to delay. 
KEYREP [$02DA (730)] determines the repeat rate in vertical blanks. 
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KEYBOARD CLICK 

The keyboard click of the XL/XE is heard through the TV speaker. The click may be turned 
off by putting $FF in NOCLIK [$02DB (731)]. 



NON-HANDLER, NON-CIO KEYS 

The [OPTION], [SELECT] and [START] keys are read from the console switch register, 
CONSOL[$D01F (53279)]. 

The console switch register 
76543210 
CONSOL 10 10 10 [0 1 SP lOP I SE|ST| 

8 4 2 1 



ST = [START] 

SE = [SELECT] 

OP = [OPTION] 

SP Console speaker. set to 1 during vertical blank. 

toggleing this bit operates the speaker (which 

is heard through the TV on XL/XE models) . 

This bit always reads 

The [HELP] key on XL and XE models is read from HELPFG, [$02DC (732)]. This address is 
latched and must be reset to zero after being read. 



The [HELP] key register 
76543210 
HELPFG ICSOHOOOHI 



16318421 
2 4 2 6 



H 1 = [HELP] (bits and 4) 
S 1 = [SHIFT] 
C 1 = [CONTROL] 



Useful database variables and OS equates 



KEYDEF 


$0079,2 


(121) 


KRPDEL 


$02D9 


(729) 


KEYREP 


$02DA 


(730) 



key code coversion table vector (XL/XE) 
delay before key repeat (XL/XE) 
key repeat rate (XL/XE) 
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$FF turns off key click (XL/XE) 
[HELP] key (XL/XE) 
ATASCII Code for last key 
keycode, $FF if no key has been pressed 
break key flag, = break key pressed 
Key delay and repeat timer 
SHIFT/CTRL lock flag 



NOCLIK $02DB (731) 

HELPFG $02DC (732) 

ATACHR $02FB (763) 

CH $02FC (764) 

BRKKEY $0 011 (17) 

SRTIMR $022B (555) 

SHFLOK $02BE (702) 

$00 = lower case 

$40 (64) = upper case lock 

$80 (128) = CTRL lock 

INVFLG $02B6 (694) : inverse video flag, non-zero = inverse 

CONSOL $D01F (53279) : start, select and option keys 

IRQEN $D20E (53774) : IRQ interrupt enable 

bit 7 enables [BREAK] 

bit 6 enables other keys 



shadow registers 



POKMSK $0010 (16) : IRQEN shadow 



Go to chapter 4 
Go to chapter 6 



CHAPTER 6 

The printer handler (P:) 



The printer is a write only device so the printer handler has no input functions. The printer 
handler has no special functions other than the CIO functions common to all other devices. 

Although many printers have special functions, the printer handler has no control over them. 
See your printer manual for information on special functions. 



Go to chapter 5 
Go to chapter 7 



CHAPTER 7 
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The screen editor (E:) 



The screen editor uses both the keyboard handler and the screen handler to provide 
interactive control of the computer. In fact, the keyboard handler, the screen handler and the 
screen editor are contained in a single section of code and are therefore very closely related. 

The editor works with one line of characters at a time. The lines it works with are called 
logical lines and are up to three screen lines long. 

The screen editor inputs data from the keyboard and then prints the data on the screen. 
When the [RETURN] key is pressed, the editor inputs all of the data on the present logical 
line for processing by CIO. 

If characters are typed on the screen, and then the cursor is moved off the line, then back on 
the line, and new characters are typed, only the characters to the right of the reentry point of 
the cursor are input when [RETURN] is pressed. However, if the cursor is moved off the line 
again, then moved back on, all characters on that logical line are input. 

If bit of ICAX1 is 1 , the editor will act as if the [RETURN] key is being held down. This bit 
may be changed at any time. 

Editor control codes 

The screen editor treats certain AT ASCI I codes as special control codes. 



Screen editor control codes 



KEY 



HEX 



DEC 



FUNCTION 



[RETURN] 


$9B 


[CLEAR] 


$7D 


[UP ARROW] 


$1C 


[DOWN] 


$1D 


[LEFT] 


$1E 


[RIGHT] 


$1F 


[BACK S] 


$7E 


[SET TAB] 


$9F 


[CLEAR 




TAB] 


$9E 


[TAB] 


$7F 


[SHIFT] 




[INSERT] 


$9D 


[SHIFT] 




[DELETE] 


$9C 


[CTRL] 




[INSERT] 


$FF 


[CTRL] 




[DELETE] 


$FE 


[ESCAPE] 


$1B 



155 carriage return or EOL 

125 Clear screen, put cursor in upper left 

28 Move cursor up one screen line 

2 9 down one line 

30 left one character 

31 right one character 
125 Back-space operation 
159 sets tab stop at cursor 

158 Clear tab stop at cursor 

127 move to next tab stop 

157 Make space for a new line 

156 delete the logical line at the cursor 

255 make room for a character 

254 delete character at cursor 

27 causes next non-EOL code to be 
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displayed as an ATASCII character, even if it is an editor 

control code 
[CTRL] [1] screen print start/stop 

[CTRL] $FD 



Goto chapter 6 
Go to chapter 8 



CHAPTER 8 

The display handler (S:) 



The display handler manages the computer's video display. Although no data ever leaves 
the computer through it, the display is treated like any other CIO device. Data sent to the 
screen may be displayed as either characters or point by point graphics. Although it is only 
visible in the 40 column text mode, mode 0, there is a cursor on the screen in all of the text 
or graphics modes. Whenever a character or graphics point is put on the screen, the cursor 
moves just as in mode 0. 

The display is capable of both input and output. Information can be put on the screen with 
any of the CIO output commands. An input command will find whatever is on the screen at 
the position of the cursor. 

When text or graphics is sent to the screen it is actually stored in an area of memory called 
the display buffer. What you see on the screen is the computer's interpretation of the data 
stored there. This will be explained further as each mode is covered. 



DISPLAY HANDLER SPECIAL FUNCTIONS: 

DRAW 
FILL 

SPECIAL ERROR STATUSES: 

$84 (132) Invalid special command. 

$8D (141) Cursor out of range. 

$91 (145) Nonexistant screen mode. 

$93 (147) Insufficient ram for screen mode. 
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TEXT MODE 

In graphics mode 0, data passes through CIO, and is stored in the display buffer in the 
following format. 



76543210 
|I| Data 1 

I 1 = displays character in inverse video. 

Bits through 6 select one of the 128 characters in the ATASCII set. 

If bit seven = 1 , the character is displayed in inverse video. Converting the above byte to 
decimal will give the BASIC ASC(x) equivalent. 

The characters displayed in the text modes are determined by tHE ATASCII character set. 
This is a bit by bit representation of how the characters appear on the screen. The character 
set starts $E000 (57344) in the operating system ROM. From there, for 1K of memory, each 
eight bytes holds a "bit map" of a particular character. Below is how the letter A is stored in 
the character set. 



Letter A as represented in the C-set 

76543210 
$E208 100000000 

00011000 

001111001 **** 

01100110 

01100110 

011111101 ****** 

01100110 
$E20F 100000000 



XL and XE models have an international character set starting at $CCOO (55224). In this 
character set the graphics characters are replaced by international characters. 

Custom characters sets may be loaded at any free address which is a multiple of 1 ,024 
($0400, or 1 K). The database variable CHBAS [$02F4 (756)] stores the most significant byte 
(MSB) of the address of the active C-set. Since the LSB of the C-set address is always $00, 
no LSB is needed to find it. 
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The data stored in the display buffer does not use the ATASCII code. A special code needed 
by the ANTIC chip is used. 



DISPLAY CODE / ATASCII CODE CONVERSION: 

ATASCII display 

$00 - $1F ( - 31) = $40 - $5F (64 - 95) 
$20 - $5F (32 - 95) = $00 - $3F ( - 63) 
$60 - $7F (96 - 127) = unchanged 

The codes for inverse video (the above codes with bit 7 set (= 1) or the above codes + 128 in 
decimal) are treated likewise. 

When you first turn on the computer, BASIC opens channel to the screen editor (E:). The 
screen editor uses both the keyboard handler and the screen handler, in mode 0, to display 
characters when they are typed in. 



TEXT MODES 1 AND 2 

Graphics modes 1 and 2 offer a split screen configuration if desired. The split screen has 
four lines of mode at the bottom of the screen. 

In mode 1 the screen holds 20 characters horizontally and 24 characters vertically. In mode 
2 the characters are twice as tall so the screen holds 1 2 vertically. 

In BASIC, characters are sent to the screen with the PRINT command. Since BASIC uses 
channel 6 for graphics you must specify channel 6 in the command. For example: 



? #6; "HELLO" 

If you use a comma in place of the semicolon, ten spaces will print before the "HELLO" 

You can also use the PLOT and DRAWTO commands. In this case the COLOR command 
determines the character, as well as the color to be displayed. 

Data passes through CIO in the following form: 

76543210 
I C I I 

C determines the color. 
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Default 


Color 


Shadow 


Color 


Register 


Register 


green 


COLPFl 


COLORl 


gold 


COLPFO 


COLORO 


gold 


COLPFO 


COLORO 


green 


COLPFl 


COLORl 


red 


C0LPF3 


COLORS 


blue 


C0LPF2 


C0L0R2 


blue 


C0LPF2 


C0L0R2 


red 


C0LPF3 


COLORS 



D is a 5 bit ATASCII code which selects the character to be displayed. The database variable 
CHBAS selects between upper case (CHBAS=$EO (224)) and lower case (CHBAS=$E2 
(226)). 



GRAPHICS MODES 3 THROUGH 11 

Modes 3 through 8 offer a split screen mode. In modes 9 through 1 1 special programming is 
required for split screens. 

These modes use dot by dot (pixel by pixel) graphics instead of character sets. Before 
explaining how graphics are sent to the screen through CIO, I will describe how the data in 
the display buffer is interpreted by the ANTIC chip. 

Mode 8 is the simplest of the graphics modes. Each byte of the display buffer controls eight 
pixels horizontally. The first 40 bytes of the display buffer control the first horizontal line of 
graphics. This makes a total of 320 pixels horizontally. If one of the eight bits of a byte is a 1 
then the pixel it controls is on. If a bit is a then it's pixel is off. For example, if a particular 
byte is equal to $9B (binary 1 0011 011 ) then its' part of the screen would look like... 



* * * * 



(10011011) 

In reality the pixels are assigned to different color registers. A color register is a byte of 
memory which controls the color of all pixels assigned to it. In mode 8, if a bit is = it's pixel 
is assigned to the register called COLBK. If a bit is one, it's pixel is assigned to COLPFO. 
See COLORS below for more information on the color registers. 

You may notice a close similarity between mode and mode 8. The major difference 
between these modes is where the dot by dot information comes from. In mode 8 this 
information comes from the display buffer. In mode the display buffer contains codes telling 
what characters to display. The actual dot by dot information comes for the character set at 
$E000. 

In mode 7 each pixel is controlled by two bits. Therefore each byte only controls four pixels. 
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There are also only 1/4 as many pixels on the screen as in mode 8. See mode 3 below for an 
explanation of how the each byte affects the pixels. 

In a graphics mode, when CIO sends a byte of data to the screen handler, that byte has 
information for only one pixel. Do not confuse a byte which CIO sends to the screen handler 
with the bytes in the display buffer. 

CIO sends data to or retrieves data from the screen in the following forms. 



76543210 
10 01 D I Modes 3,5,7 — D = color 



lOOOOOOOIDI Modes 4,6,8 — D = Color 



01 D I Modes 9,10,11 — D = data 



Mode 3 uses a screen which is 40 pixels horizontally and 24 vertically. Each pixel is a square 
the size of a mode character. It requires 273 bytes of RAM where each byte controls 4 
pixels. Each pair of bits controls which of the four color registers their pixel is assigned to. 



display buffer byte for mode 3 
76543210 
D I D I D I D i 

PI P2 P3 P4 

Pixel/color register assignments: 



00 


COLBK 


(C0L0R4) 


01 


COLPFO 


(COLORO) 


10 


COLPFl 


(COLORl) 


11 


C0LPF2 


(C0L0R2) 



Mode 4 uses a screen of 80 columns by 48 rows. Each pixel is half the size of those in mode 
3. Mode 4 requires 537 bytes of RAM where each byte controls 8 pixels. This mode is very 
similar to mode 8 except there are fewer but larger pixels. 

Mode 5 uses a screen of 80 columns by 48 rows. The pixels are the same size as in mode 4. 
Mode 5 requires 1 ,017 bytes of RAM where each byte controls 4 pixels in the same manner 
as in mode 3. 

Mode 6 uses a screen of 160 columns by 96 rows. It requires 2,025 bytes of RAM where 
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each byte controls 8 pixels as in mode 4. 

Mode 7 uses a screen of 160 columns by 96 rows. It requires 3,945 bytes of RAM where 
each byte controls 4 pixels as in modes 3 and 5. 

Modes 8 through 1 1 (and 15 on XL and XE models) each require 7,900 bytes of RAM and 
are very similar in display set up. The main differences between these modes is the 
interpretation of data in the display buffer. 

Mode 15 (sometimes called mode 7.5) uses a screen of 160 columns by 192 rows. Each 
byte controls 4 pixels as in mode 7. The main difference between mode 15 and its related 
modes is bit of each instruction byte in the display list (the program which the ANTIC chip 
uses). If this bit is the screen is interpreted as mode 15. If the bit is 1 the screen is 
interpreted as modes 8 through 1 1 . 

Modes 8 through 1 1 are set up identically in memory, including the display list. The only 
difference is the data in the PRIOR register of the GTIA chip. The shadow register for PRIOR 
is GPRIOR [$026F (623)]. 

Mode 8 (PRIOR = $00 - $3F (0 - 63)), uses a screen of 320 columns by 192 rows. Each 
byte controls 8 pixels as in modes 4 and 6. 

Mode 9 (PRIOR = $40 - $7F (64 - 1 27)) uses a screen of 80 columns by 1 92 rows. Each 
byte controls 2 pixels. The pixels are all of the same color, controlled by COLBK. Each half of 
a byte in the display buffer controls the luminance of the assigned pixel. The format of each 
byte is as follows. 



76543210 

I data 1 data | 

pixel 1 I pixel 2 



Mode 1 (PRIOR = $80 - $BF (1 28 - 1 91 ), is the same as mode 9 except 9 color luminance 
combinations are available. The data in each half byte chooses one of the 9 color registers 
for the assigned pixel. 

Mode 1 1 (PRIOR = $C0 - FF (1 92 - 255), is the same as mode 9 except there is one 
brightness but 16 colors. The pixel data chooses one of the 16 available colors. The 
luminance is that of the background (COLBK). 



USING THE SCREEN HANDLER 
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OPENING A CHANNEL TO THE SCREEN HANDLER 

When a channel is opened to the screen handler the following actions take place: 

The area of memory to be used for the screen data is cleared. 

A display list (program for the ANTIC chip) is set up for the proper graphics mode. 

The top-of-free-memory pointer, MEMTOP [$02E5,2 (741)], is set to point to the last free 
byte before the display list. 

Before opening a channel to the screen handler, the pointer to the highest memory address 
needed by the program, APPMHI [$000E,2 (14)], should be properly set. This will prevent the 
screen handler from erasing part of the program when it sets-up the screen data region. 

When the channel is opened, two special options can be sent with the direction parameter 
(ICAX1). 

ICAXl for screen open 
76543210 

t C S W R I 

16318421 
2 4 2 6 



C 1 = don't clear the screen 

S 1 = split screen 

R 1 = input 

W 1 = output 

Before the open command, the graphics mode number is placed into ICAX2. 



ICAX2 for screen open 
76543210 
I : mode I 

mode = $00 through $0B (0 - 11 (0 - 15 on XL/XE) ) 

To open a channel to the screen in BASIC use the GRAPHICS command. 

BASIC screen open format 
GRAPHICS mode 
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For Example : 
GRAPHICS 8 

This will set up a mode 8 graphics screen and open channel 6 to it. If the graphics mode is 1 
- 8, a split screen will be set up. For example, GRAPHICS 8 will set up a mode 8 screen with 
a four line text window at the bottom. 

If 1 6 is added to the mode number, a full screen will be set-up. For example, GRAPHICS 
8+1 6 or GRAPHICS 24 will set up a mode 8 screen, with no text window, a full 1 92 pixels 
high. If the number 32 is added to the mode number, the screen will not clear when the 
channel opens. 

If you want to use a channel other than #6, you will have to use the open command. It is 
used in the following format. 



screen open without GRAPHICS command 
OPEN tchannel, direction/special, mode, S : 

For example : 
OPEN #1, 8, 7, S: 

This will open channel 1 to a mode 7 screen for output only. For use of special parameters, 
see ICAX1 above. 



USING AN OPEN CHANNEL TO THE SCREEN 

Once a channel is opened to the screen it is used like any other input or output device. In 
other words, data is placed on the screen by the PRINT and PUT commands. Data is 
retrieved from the screen with the INPUT and GET commands. The part of the screen which 
the data will be put in or taken from is determined by the X,Y coordinants in the database 
variables COLCRS [$0055,2 (85)] and ROWCRS [$0054 (84)]. What appears on the screen 
depends on what graphics mode the computer is in. 

Before sending data to the screen in BASIC, a color register must be assigned to the data. 
Once a point is plotted on the screen, it's color will be determined by the color register it was 
assigned to. 

To assign a color to a ploted point, the COLOR command us used as follows. 



COLOR command format 
COLOR register 
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For example, 
COLOR 1 

After using the above command, all points plotted will be controlled by color register 1 . To 
change color registers, use the COLOR command again. 

In assembly language, the color is determined by the data sent to the screen. See the above 
section on graphics modes for color information. 

In BASIC the PLOT command is used to put data on the screen. The PLOT command is 
used as follows. 



The BASIC PLOT command 
PLOT x,Y 

X and y are the horizontal and vertical coordinates for the plotted point. 

In modes 3 through 1 1 a single point will be plotted. In modes 1 and 2 a text character will be 
printed on the screen by the PLOT command. 

The PRINT and PUT commands can also be used in basic. What appears on the screen 
depends on the graphics mode. 

In modes 1 and 2 the ATASCII characters sent to the screen will be printed just as in mode 
0. See the paragraph on modes 1 and 2 above for more information. In the other modes 
what appears depends on how the ANTIC chip interprets the data bytes sent to the screen. 
For example, in mode 8, even numbered characters will be single pixels in color 1 . Odd 
numbered characters will be in color (background). 

There are two special commands for the screen handler, DRAW and FILL 

DRAW (ICCOM = $1 1 (17)) 

The draw command works exactly like the plot command except a straight line is drawn from 
the previous pixel to the new one. In BASIC it is used in the following format. 

the BASIC DRAW command 
DRAWTO x,Y 

FILL (ICCOM = $12 (18)) 

Fill works like draw except the area to the right of the drawn line will be filled with the color in 



43 



FILDAT [$02FD (765)]. The fill command expects to find a boundary to the right. If no 
boundary is found, the entire horizontal screen between the ends of the line is filled. 

To use the fill command in BASIC the XIO command must be used in the following format. 



POSITION x,Y 

XIO 18 #6, 0, 0, "E:" 

Note that the cursor is first moved by the POSITION command. Below is an example of how 
to prepare for and use the fill command. 



using the fill command 

2nd DRAWTO . . DRAWTO here 

I I 
I I 
I I 
fill to here ! ! PLOT here 



This will draw and fill a box on the screen. 



THE COLOR REGISTERS 

There are nine bytes of memory which control the colors on the screen. These bytes are 
called color registers. The color registers have the following names and relationships. 



Color registers and relationships 

Register Register modes 

name address 

0&8 1&2 357 4&6 9&11 
10 





HEX 


decimal 


COLOR numbers 




PCOLRO 


$02C0 


704 

















PCOLRl 


$02C1 


705 






1 










PC0LR2 


$02C2 


706 






2 










PC0LR3 


$02C3 


707 






3 










COLORO 


$02C4 


708 


0-63 


1 


4 










COLORl 


$02C5 


709 


1 - 255 64 -127 


2 


5 











44 



C0L0R2 

6 

COLORS 

7 

C0L0R4 


$02C6 


710 





128-191 


$02C7 


711 




192-255 


$02C8 


712 


border 


backgnd 



backgnd backgnd 



The color numbers are in decimal. These are actually shadow registers. See the O.S. 
equates below for relationships. In modes - 3 the COLOR number actually determines the 
character printed 

The register to which a pixel/character is assigned to is determined by the data byte sent to 
the screen through CIO. 

The data in the color registers in in the following format. 



Color register data format 
76543210 
I color I bright | 

color = one of 16 possible colors 
bright = one of 8 possible brightnesses 
(even numbers, - E) 

In basic, the COLOR command is used to assign color registers. The corresponding 
registers depends on the graphics mode. For example, COLOR is C0L0R2 in mode 8. In 
most other modes COLOR is C0L0R4. See the above chart for the register relationships. 

To change the contents of the color registers in BASIC, the SETCOLOR command is used. 
In all modes except mode 10, the SETCOLOR command refers to the registers COLORO to 
C0L0R4. 



SETCOLOR/register relationships 



SETCOLOR 





COLPFO 


(COLORO) 


SETCOLOR 


1 


COLPFl 


(COLORl) 


SETCOLOR 


2 


C0LPF2 


(C0L0R2) 


SETCOLOR 


3 


C0LPF3 


(C0L0R3) 


SETCOLOR 


4 


COLBK 


(C0L0R4) 



The format for the SETCOLOR command is... 

SETCOLOR command format 
SETCOLOR register, hue, brightness 
register =0-4 (0 - 8 in mode 10) 
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hue =0-15 (16 colors) 

brightness =0-16 (even numbers only (8 brightnesses) 

The following chart gives the colors represented by the hue number. 



colors represented by hue numbers 






grey 


8 


blue 


1 


gold 


9 


cyan 


2 


gold-orange 


10 


blue-green 


3 


red-orange 


11 


blue-green 


4 


orange 


12 


green 


5 


magenta 


13 


yellow-green 


6 


purple-blue 


14 


yellow 


7 


blue 


15 


yellow-red 



The attract mode 

If a key is not pressed for more than 9 minutes the computer will enter the attract mode. This 
mode is used to prevent burning of the TV phosphors by lowering the brightness and 
constantly changing the colors. The attract mode timer, ATRACT [$004D (77)], is set to 254 
($FE) when the the attract mode is entered. To force the computer out of the attract mode, 
poke a number less than 127 into ATRACT. 



Useful database variables and OS equates 



APPMHI 


$000E,2 


(14) 


ATRACT 


$004D 


(77) 


LMARGN 


$0052 


(82) 


RMARGN 


$0053 


(83) 


ROWCRS 


$0054 


(84) 


COLORS 


$0055,2 


(85) 


DINDEX 


$0057 


(87) 


SAVMSC 


$0058,2 


(88) 


OLDROW 


$005A 


(90) 


OLDCOL 


$005B,2 


(91) 


OLDOHR 


$005D 


(93) 


OLDADR 


$005E,2 


(94) 


RAMTOP 


$006A 


(106) 


SDLSTL 


$0230,2 


(560) 


TXTROW 


$0290 


(656) 


TXTCOL 


$0291,2 


(657) 


TXTMSC 


$0294,2 


(660) 


RAMS I Z 


$02E4 


(740) 


CRSINH 


$02F0 


(752) 


FILDAT 


$02FD 


(765) 


DSPFLG 


$02FE 


(766) 


SSFLAG 


$02FF 


(767) 


COLPMO 


$D012 


(53266) 


COLPMl 


$D013 


(53267) 


C0LPM2 


$D014 


(53268) 


C0LPM3 


$D015 


(53269) 


COLPFO 


$D016 


(53270) 



lower limit for screen region 

attract mode timer and flag 

left margin 

right margin 

horizontal cursor position 

vertical cursor position 

current graphics mode 

starting address of display buffer 

previous cursor position 
II II II 

character currently at the text cursor 

memory address of cursor 

end-of-RAM + 1 (MSB only) 

shadow register of display list address 

text window cursor position 
II II II II 

starting address of text window data buffer 

permanent end-of-RAM + 1 (MSB only) 

cursor inhibit, 1 = no cursor 

color data for fill 
if >0 screen control codes are displayed as 
ATASCIl characters (EOL is uneffected) 

> = stop screen print 

actual color registers 

loaded from shadow 

registers during 

vertical blank 
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COLPFl 


$D017 


(53271) 


see above 


C0LPF2 


$D018 


(53272) 


for use 


C0LPF3 


$D019 


(53273) 




COLBK 


$D020 


(53274) 





OS shadow registers 



PCOLRO 


$02C0 


(704) 


COLPMO 


PCOLRl 


$02C1 


(705) 


COLPMl 


PC0LR2 


$02C2 


(706) 


C0LPM2 


PC0LR3 


$02C3 


(707) 


C0LPM3 


COLORO 


$02C4 


(708) 


COLPFO 


COLORl 


$02C5 


(709) 


COLPFl 


C0L0R2 


$02C6 


(710) 


C0LPF2 


C0L0R3 


$02C7 


(711) 


C0LPF3 


C0L0R4 


$02C8 


(712) 


COLBK 



Go to chapter 7 
Go to chapter 9 



CHAPTER 9 



The resident disk handler 



The resident disk handler is separate from DOS and is part of the permanent operating 
system ROiVl. The disk handler does not use CIO. 

The resident disk handler works with one sector at a time. It is used by setting the drive 
number, sector number, and operation code in the device control block. The program then 
jumps (JSR) to the handler entry vector, DSKINV [$E453 (58451)]. 



Device control block (for resident disk handler) 
DDEVIC [$0300 (768)] 

Serial bus I.D. Set by handler 
DUNIT [$0301 (769)] 

Drive number 
DCOMND [$0302 (770)] 

Command byte 
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DSTATS [$0303 (771)] 

status byte 

DBUFLO [$0304 (772)] 
DBUFHI [$0305 (773)] 

Pointer to 128 byte memory block for data storage. 

DTIMLO [$0306 (774)] 

Timeout value (response time limit) in seconds 

DBYTLO [$0308 (776)] 
DBYTHI [$0309 (777) ] 

number of bytes transferred, set by handler 

DAUXl [$030A (778)] 
DAUX2 [$030B (779)] 

sector number 



DISK HANDLER COMMANDS 



GET SECTOR 

Before the JSR to DSKINV is made the following parameters are set. 

GET SECTOR parameters 

DCOMND = $52 (82) 

DUNIT = (1-4) 

DBUFHI 

and 

DBUFLO = address of 128 byte buffer 

DAUXl 

and 

DAUX2 = Sector number (LSB,MSB) 

This operation will read the specified sector and put the data into the specified buffer. 



PUT SECTOR 

PUT SECTOR is used the same as GET SECTOR except for DCOMND. 
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PUT SECTOR parameters 
DCOMND = $50 (80) 

This operation sends the data in the specified buffer to the specified disk sector. 
PUT SECTOR WITH VERIFY 

PUT SECTOR WITH VERIFY is used the same as PUT SECTOR except for DCOMND. 

PUT SECTOR WITH VERIFY parameters 
DCOMND = $57 (87) 

This operation sends the data in the specified buffer to the specified disk sector then checks 
for errors. 



GET STATUS 

Only the DUNIT and DCOMND need to be set 

GET STATUS parameters 

DCOMND = $53 (83) 
DUNIT = (1-4) 

The status information will be put in three bytes starting at DVSTAT [$02EA (746)]. 

Status format 
76543210 
DVSTAT + I command stat | 
+ 1 I hardware stat | 
+ 2 I timeout value | 



The command status byte gives the following information. 
Bit 



49 



1 = invalid command frame received 

1 1 = invalid data frame received 

2 1 = unsuccessful PUT operation 

3 1 = disk is write protected 

4 1 = active/standby 



The hardware status byte contains the status register of the ISN1 771 -1 disk controller chip. 
The timeout byte contains the maximum allowable response time for the drive in seconds. 



FORMAT DISK 

The handler will format then verify the the disk. The numbers of all bad sectors (up to 63) wil 
be put into the specified buffer followed by two bytes of $FF. 

The following parameters are set before the call. 



FORMAT parameters 

DCOMND = $21 (33) 

DUNIT = (1-4) 

DBUFLO 

and 

DBUFHI = address of bad sector list (buffer) 

After the operation the status byte is set. Also, DBYTLO and DBYTHI will contain the number 
of bytes of bad sector information (not including the two $FF bytes). 



Useful data base variables and OS equates 



DVSTAT 


$02EA, 3 


(746) 


device status block, 3 bytes 


DDEVIC 


$0300 


(768) 


serial bus I.D. 


DUNIT 


$0301 


(769) 


device number 


DCOMND 


$0302 


(770) 


command byte 


DSTATS 


$0303 


(771) 


status byte 


DBUFLO 


$0304 


(772) 


data buffer 


DBUFHI 


$0305 


(773) 


pointer 


DTIMLO 


$0306 


(774) 


timeout value 


DBYTLO 


$0308 


(776) 


number of bytes transfered 


DBYTHI 


$0309 


(777) 




DAUXl 


$030A 


(778) 


sector 


DAUX2 


$030B 


(779) 


number 


DSKINV 


$E453 


(58451) 


disk handler entry vector 



Go to chapter 8 
Go to chapter 10 
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CHAPTER 10 

System interrupts 



There are four types of interrupts which can occur with the 6502 microprocessor: 
6502 interrupts 



1 . chip reset 

2. IRQ, interrupt request (maskable) 

3. MNI (non-maskable interrupt) 

4. software interrupt (BRK instruction) 



CHIP RESET 

On the 400/800 the chip reset occurs only upon power-up and causes the computer to do a 
cold start. On later models, pressing [SYSTEM RESET] will cause a chip reset but the 
computer then does a warm start. On the 400/800, the [SYSTEM RESET] key generates a 
NMI interrupt. 



COLD START 

This is a synopsis of the cold start routine. 

1 . The warm start flag [$0008] is set to (false) 

2. If a cartridge slot contains a diagnostic cartridge, control is handed to the cartridge. 

3. The end of RAM is determined by trying to complement the first byte of each 4K block 
of memory. 

4. Hardware registers at $D000 - $D4FF (except $D100 - $D1 FF) are cleared. 

5. RAM is cleared from $0008 to the top of ram. 

6. The user program jump vector, DOSVEC [$000A] is set to point to the black board 
mode (Atari logo display mode in XL/XE models). 
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7. The screen margins are set to 2 and 39 

8. Interrupt vectors are initialized. 

9. Bottom of free RAM pointer, MEMLO [$02E7], is set to point to $0700. 

10. Resident CIO handlers are initialized. 

11 . If the [START] key is pressed the cassette boot request flag, CKEY [$004A], is set. 

12. The CIO device table is initialized. 

13. If a cartridge is present it is initialized. 

14. Channel is opened to the screen editor. The top-of-free-RAM pointer, MEMTOP 
[$02E5], is set to point below the screen region. The computer then waits for the 
screen to be established before continuing. 

15. If the cassette boot flag is set the cassette is booted. 

16. If there is no cartridge present or a cartridge doesn't prevent it, the disk is booted. 

17. The cold start flag is reset. 

18. If there is a cartridge present, the computer jumps to the cartridge's run vector. 

19. If there is no cartridge present the computer jumps through the vector DOSVEC 
[$000A (10)]. DOSVEC will point to either a booted program, the memo pad routine 
(400/800) or the logo display routine (XL/XE). 

WARM START 

1 . The warm start flag is set to $7F (true). 

2. cold start steps 2 - 4 are executed. 

3. RAM is cleared from $0010 - $007F and $0200 - $03FF. 

4. Cold start steps 7 - 14 are executed. 

5. If cassette booted software is present the computer JSRs through CASINI [$0002]. 

6. If disk booted software is present the computer JSRs through DOSINI [$000C (12)]. 
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The difference between cold start and warm start is the condition of the warm start flag, 
WARMST, [$0008]. If this flag is a complete cold start is executed. If the flag is anything 
other than then only the warm start part of the warm start/cold start code is executed. 



NON-MASKABLE INTERRUPTS (NMI) 

NMI interrupts are generated by the following conditions: 

1 . Display list interrupt, generated by the ANTIC chip. 

2. TV vertical blank interrupt, generated by the ANTIC chip. 

3. [SYSTEM RESET] key (400/800). 

When an NMI interrupt occurs, the hardware register NMIST [$D40F] is examined to 
determine what type of interrupt occurred. The computer is then directed through the proper 
ram vector to service the interrupt. 



DISPLAY LIST INTERRUPTS (DLIs) 

The computer makes no use of DLIs. The ram vector points to an RTI instruction. 

VERTICAL BLANK INTERRUPTS (VBIs) 

There are two stages to the VBI service routine. The second stage is only done if a critical 
function was not interrupted. 

Stage 1 (VBI) 

The real time clock, RTCLOK [$0012 - $0014], is incremented. 

The attract mode variables are processed. 

System timer 1 is decremented. If it goes to zero the computer JSRs through system 
time-out vector 1 . 

Stage 2 (VBI) 

The hardware registers are loaded with the data in their shadow registers. 

System timer 2 is decremented. If it goes to zero the computer JSRs through the system 
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time-out vector 2. 

System timers 3, 4, and 5 are decremented. If a timer goes to zero the computer sets system 
timer flags 3, 4, and/or 5. 

If auto-repeat is active, the auto-repeat process is done. 

The keyboard debounce timer is decremented if not 0. 

Information at the controller port registers is read, processed and placed in the proper 
shadow registers. 

[SYSTEM RESET] INTERRUPT 

If a [SYSTEM RESET] interrupt is generated on the 400/800 the computer jumps to the 
warm start routine. 



INTERRUPT REQUESTS (maskable interrupts (IRQs)) 

When an IRQ interrupt occurs the hardware register IRQST [$D20E], the PIA status 
registers, PACTL [$D302] and PBCTL [$D303] are examined to determine what caused the 
interrupt. 

For each interrupt, the 6502 accumulator is pushed to the stack. The computer is then 
directed to the proper ram vector to service the interrupt. 



SOFTWARE INTERRUPT (BRK instruction) 

The operating system doesn't use software interrupts. The software interrupt vector points to 
a PLA followed by an RTI. 



Interrupt vectors 

Label address type function 

VDSLST $0200 NMI DLI Points to an RTI 

VVBLKI $0222 NMI stage 1 VBI 

VVBLKD $0224 NMI return-f rom-interrupt routine 

CDTMAl $0226 NMI time-out 1 (used by SIO) 

CDTMA2 $0228 NMI time-out 2 (not used by OS) 

VPRCED $0202 IRQ not used (points to PLA, RTI) 

VINTER $0204 IRQ not used (PLA, RTI) 

VKEYBD $0208 IRQ keyboard interrupt 

VSERIN $020A IRQ used by Serial I/O routine 
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EROR 


$020C 


IRQ 


used by SIO 


EROC 


$020E 


IRQ 


used by SIO 


IMRl 


$0210 


IRQ 


not used by OS (PLA,RTI 


IMR2 


$0212 


IRQ 


not used by OS (PLA,RTI 


IMR4 


$0214 


IRQ 


9 


MIRQ 


$0216 


IRQ 


main IRQ code 


REAR 


$0206 


BRK 


unused by OS (PLA,RTI) 



SYSTEM TIMERS 

The following timers are updated during vertical blank (VBI) as noted above. If a timer is 
decremented to the computer jumps through it's associated vector or sets it's associated 
flag. 



Label 


address 


flag/vector 








RTCLOK 


$0012 


3 byte 


clock 


($0012 = 


- MSB) 




CDTMVl 


$0218 


CDTMAl 


$0226 


vector 


(SIO time- 


-out) 


CDTMV2 


$021A 


CDTMA2 


$0228 


vector 






CDTMV3 


$021C 


CD IMF 3 


$022A 


flag 






CDTMV4 


$021E 


CD IMF 4 


$022C 


flag 






CDTMV5 


$0220 


CDTMF5 


$022E 


flag 







HARDWARE INTERRUPT CONTROL 

There are two registers on the antic chip which control interrupts. These registers can be 
used to disable interrupts if necessary. There are also two associated interrupt status 
registers. 

The IRQ enable and status registers use the same address. The result is that reading the 
register does not reveal the enabled interrupts but the interrupts pending. IRQ interrupt 
enable data should usually be written to the QS shadow first. Reading the QS shadow tells 
which interrupts are enabled. 



Non maskable interrupt enable 
NMIEN $D40E 

76543210 
I I I not used | 



bit 7 1 = DLI enabled 
6 1= VBI enabled 
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Non maskable interrupt status 
NMIST $D40F 

76543210 
I I I I not usedl 



bit 7 1 = DLI pending 
5 1 = VBI pending 
5 1 = [SYSTEM RESET] key pending 



Interrupt request enable 
IRQEN $D20E 

76543210 
I I I I I I I I I 



bit 7 1 = [BREAK] key interrupt enable 

5 1 = keyboard interrupt enable 

5 1 = serial input interrupt enable 

4 1 = serial output interrupt enable 

3 1 = serial output-finished interrupt enable 

2 1 = timer 4 interrupt enable 

1 1 = timer 2 interrupt enable 

1 = timer 1 interrupt enable 

IRQEN has a shadow register, POKMSK [$0010 (A)]. 



Interrupt request status 
IRQST $D20E 

76543210 
I I I I I I I I I 



bit 7 1 = [BREAK] key interrupt pending 

6 1 = keyboard interrupt pending 

5 1 = serial input interrupt pending 

4 1 = serial output interrupt pending 

3 1 = serial output-finished interrupt pending 

2 1 = timer 4 interrupt pending 

1 1 = timer 2 interrupt pending 

1 = timer 1 interrupt pending 
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WAIT FOR HORIZONTAL SYNC 

Writing any number to WSYNC [$D40A (54282)] will cause the computer to stop and wait for 
the next TV horizontal sync. 

It is wise to use DLIs one TV line before needed then writing to WSYNC. This will keep other 
interrupts from causing DLIs to be serviced late. This can cause a DLI to change something 
in the middle of a scan line. 



Useful database variables and OS equates 

POKMSK $0 010 (16) : IRQEN shadow 

IRQEN $D20E (53774) : enables IRQs when written to 

IRQST $D20E (53774); gives IRQs waiting when read 

PACTL $D302 (54018) : bit 7 (read) peripheral A interrupt status 

bit (write) peripheral A interrupt enable 
PBCTL $D303 (54019) : bit 7 (read) peripheral B interrupt status 

bit (write) peripheral B interrupt enable 
WSYNC $D40A (54282) : wait for horizontal sync 
NMIEN $D40E (54286) : NMI enable 
NMIST $D40F (54287) : NMI status 



Go to chapter 9 
Go to chapter 1 1 



CHAPTER 11 



The Floating Point arithmethic Pacl<age 



The routines which do floating point arithmetic are a part of the operating system ROM. The 
Atari computer uses the 6502's decimal math mode. This mode uses numbers represented 
in packed Binary Coded Decimal (BCD). This means that each byte of a floating point 
number holds two decimal digits. The actual method of representing a full number is 
complicated and probably not very important to a programmer. However, for those with the 
knowledge to use it, the format is given below. 



Floating point number representation 
byte XX excess 64 exponent + sign 

XX \ 
XX \ 

XX > 10 BCD digits 
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byte 7 



XX / 
XX / 



The decimal point is shifted to left of the MSD and the exponent is adjusted accordingly. 
Therefore, the decimal point doesn't need to be represented. 

For programming purposes, floating point numbers can be in ASCII code. It takes up to 14 
bytes to store a floating point number in this manner. The floating point package has a 
routine to convert numbers between ASCII and floating point. 



USE OF THE FLOATING POINT PACKAGE 

The floating point package has several routines to convert between ASCII and FP and to do 
the arithmetic functions. These are the important data base variables. 



Floating point data base variables 



FRO 


$00D4, 


6 


(212) 


FRl 


$00E0, 


5 


(224) 


CIX 


$00F2 




(242) 


INBUFF 


$00F3, 


2 


(243) 


FLPTR 


$OOFC, 


2 


(252) 


LBUFF 


$0580, 


9 


(1408) 



6 byte buffer for floating point number 

6 byte buffer for floating point number 

index for INBUFF address 

2 byte pointer to ASCII floating point number 

2 byte pointer to user buffer for floating 

point number 

result buffer for FASC routine 



MAKING THE CALL 

To do a floating point function, first set the proper pointers and JSR to the operation entry 
point. Below is a list of the entry points and parameters. 

ASCII to floating point 

Converts ASCII representation pointed to by INBUFF to FP in FRO. 

AFP = $D800 

INBUFF = address of ASCII number 

CIX = buffer offset if any 

JSR AFP 

FLOATING POINT TO ASCII 
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Converts floating Point number in FRO to ASCII. The result will be in LBUFF. INBUFF wil 
point to the ASCII number which will have the bit 7 of the last byte set to 1 . 

FASC = $D8E6 

JSR FASC 

INTEGER TO FLOATING POINT CONVERSION 

Converts a 2 byte unsigned integer (0 to 65535) in FRO to floating point in FRO. 

IFP = $D9AA 

JSR IFF 

FLOATING POINT TO INTEGER CONVERSION. 

Converts floating point number in FRO to 2 byte integer in FRO. 

FPI = $D9D2 

JSR FPI BCS overflow 

ADDITION 

Adds floating point numbers in FRO and FR1 with result in FRO. 

FADD = $DA66 

JSR FADD BCS out of range 

SUBTRACTION 

subtracts FR1 from FRO with the result in FRO. 

FSUB = $DA60 

JSR FSUB BCS out of range 

MULTIPLICATION 

Multiplies FRO by FR1 with the result in FRO. 

FMUL = $DADB 

JSR FMUL BCS out of range 
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DIVISION 

Divides FRO by FR1 with result in FRO. 

FDIV = $DB28 

JSR FDIV BCS out of range or divisor is 

LOGARITHMS 

Puts logarithm of FRO in FRO 

LOG = $DECD LOG10 = $DED1 

JSR LOG ;for natural log. 

or 

JSR LOG10 ;for base 10 log. BCS negative number or overflow 

EXPONENTIATION 

Put exponentiation of FRO in FRO 

EXP = $DDCO 

EXP10 = $DDCC 

JSR EXP ;for e ** Z 

or 

JSREXP10 ;for10**Z 

POLYNOMIAL EVALUATION 

Puts the result of an n degree polynomial evaluation of FRO in FRO. 

PLYEVL = $DD40 

LDX LSB of pointer to list of floating point coefficients, ordered high to low. LDY MSB of 
above LDA number of coefficients in list 

JSR PLYEVL BCS overflow 

CLEAR FRO 
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Sets FRO to all zeroes 

ZFRO = $DA44 

JSRZFRO 

CLEAR ZERO PAGE FLOATING POINT NUMBER 

Clears user floating point number in page zero. 

ZF1 = $DA46 

LDX address of zero page FP buffer 

JSRZF1 

LOAD FRO WITH FLOATING POINT NUMBER 

Loads FRO with user FP number in buffer pointed to by 6502 X and Y registers or by FLPTR. 
After either operation below, FLPTR will point to the user FP buffer. 

FLOOR = $DD89 

LDX Isb of pointer LDY msb 

JSR FLOOR 

or 

FLD0P = $DD8D 

FLPTR = address of FP number 

JSR FLDOP 

LOAD FR1 WITH FLOATING POINT NUMBER 

Loads FR1 with user FP number in buffer pointed to by 6502 X and Y registers or by FLPTR. 
After either operation below, FLPTR will point to the user FP buffer. 

FLD1R = $DD98 

LDX Isb of pointer LDY msb 

JSRFLD1R 
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or 

FLD1P = $DD9C 

FLPTR = address of FP number 

JSRFLD1P 

STORE FRO IN USER BUFFER 

stores the contents of FRO in user FP buffer pointed to by 6502 X and Y registers or by 
FLPTR. After either operation below, FLPTR will point to the user FP buffer. 

FSTOR = $DDA7 

LDX Isb of pointer LDY msb 

JSR FSTOR 

or 

FSTOP = $DDAB 

FLPTR = address of FP number 

JSR FSTOP 

MOVE FRO TO FR1 

Moves the contents of FRO to FR1 

FMOVE = $DDB6 

JSR FMOVE 

The usual use sequence of the floating point package might be to: 

load FRO and FR1 with FP numbes from user specified buffers 

do the math 

then store FRO in a user buffer. 

An alternative might be to: 

convert an ASCII representation to FP (the result is automatically in FRO). 
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move FRO to FR1 . 



Convert the second ASCII number. 



Do the math. 



Convert FRO back to ASCII. 



Store the number back into a user buffer. 



The floating point package uses the following blocks of RAM. 



RAM used by floating point package 



$00D4 
$057E 



$OOFF 
$05FF 



If the floating point package is not used the above ram is free. 



Useful data base variables and OS equates 



FRO 


$00D4, 6 


(212) 


FRl 


$00E0, 6 


(224) 


CIX 


$00F2 


(242) 


INBUFF 


$00F3,2 


(243) 


FLPTR 


$00FC,2 


(252) 


LBUFF 


$0580 


(1408) 


AFP 


$D800 


(55296) 


FASC 


$D8E6 


(55526) 


IFP 


$D9AA 


(55722) 


FPI 


$D9D2 


(55762) 


ZFRO 


$DA44 


(55876) 


ZFl 


$DA4 6 


(55878) 


FSUB 


$DA60 


(55904) 


FADD 


$DA66 


(55910) 


FMUL 


$DADB 


(56027) 


FDIV 


$DB28 


(56104) 


FLOOR 


$DD89 


(56713) 


FLDOP 


$DD8D 


(56717) 


FLDIR 


$DD98 


(56728) 


FLDIP 


$DD9C 


(56732) 


FSTOR 


$DDA7 


(56743) 


FSTIP 


$DDAB 


(56747) 


FMOVE 


$DDB6 


(56758) 


EXP 


$DDCO 


(56768) 


EXP 10 


$DDCC 


(56780) 


PLYEVL 


$DD40 


(56640) 


LOG 


$DECD 


(57037) 


LOGIO 


$DED1 


(57041) 



system FP buffer 

system FP buffer 

INBUFF index 

pointer to ASCII FP buffer 

pointer to user FP buffer 

result buffer for FP to ASCII 

ASCII to FP 

FP to ASCII 

integer to FP 

FP to integer 

clear FRO 

clear zero page FP buffer 

FRO - FRl 

FRO + FRl 

FRO * FRl 

FRO / FRl 

load FRO by X, Y pointer 

load FRO by FLPTR pointer 

load FRl by X, Y pointer 

load FRl by FLPTR pointer 

store FRO at buffer by X,Y pointer 

store FRO at buffer by FLPTR pointer 

move FRO to FRl 

e exponentiation 

base 10 exponentiation 

polynomial evaluation 

natural log of FRO 

base 10 log of FRO 



Go to chapter 10 
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Goto chapter 12 



CHAPTER 12 

Boot software formats 



There are three ways which programs may be booted (loaded automatically upon 
power-up): 

From the disk drive 

From the cassette recorder 

From a ROM cartridge 



DISK BOOTED SOFTWARE 

The disk drive is the primary source for programs (other than the BASIC interpreter in the 
computer ROM). A program booted from disk must be a machine language program. 
Secondly, the program is arranged on disk in a different manner from the DOS files. 

When the computer is first turned on, it will attempt to read a program starting at sector one 
in disk drive one. The exceptions are, if a cartridge prevents the disk boot process or the 
[START] key is pressed. The program is expected to use all 128 bytes of each sector. 



FORMAT OF A DISK BOOTED PROGRAM 

A disk booted program begins at sector one on the disk and continues in sequence. The first 
six bytes of the first sector contain program information. The rest of the bytes contain the 
program itself. 



Disk boot program header 

1st byte $00 flags, stored in DFLAGS [$0240] 

$xx number of sectors used by program 

$xx address to start load 

$xx 



64 



$xx initialization address 
6th byte $xx 
7th byte $xx start of program 

The flags byte is usually unused and should be zero. 

The load address is stored in BOOTAD [$0242,2 (578)]. 

The initialization address is stored in DOSINI [$000C,2 (12)]. 

After the program is completely loaded the computer will JSR to the address stored in 
DOSINI for initialization. It will then jump to the address stored in DOSVEC to run the 
program. 

The initialization part of the program should set the bottom-of-free-RAM pointer, MEMLO 
[$02E7,2 (743)], to point to the end of the program + 1 . This will protect the program from the 
computer and other programs. The top-of-user-RAM pointer, APPMHI [$000E,2 (14)], is 
also usually set to point to the same address. This will protect the program from the video 
hardware. It must also set DOSVEC [$000A,2 (10)] to actually point to the run address of the 
program. The initialization should of course end with and RTS. With DOSINI and DOSVEC 
properly set, the program will restart up pressing the [SYSTEM RESET] key. 

Rmember that the load address of the program should be six bytes before where you want 
the program to reside in memory. The six byte header will load at the specified start address 
followed by the program. 



CASSETTE BOOTED SOFTWARE 

The cassette boot process is nearly identical to the disk boot process. The processes are so 
similar that cassette boot programs can usually be transferred directly to disk and 
vice-versa. The two differences are: 

The cassette is booted instead of the disk if the [START] key is pressed when the power is 
turned on. 

A bug in early operating systems requires the booted program to turn off the cassette motor 
with the following command. 



LDA #$3C 

STA PACTL [$D302] 
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CARTRIDGE BOOTED SOFTWARE 

The Atari 800 has two cartridge slots. All other models have only one. The second cartridge 
slot, slot B on the 800, resides from $8000 to $9FFF. The first slot, slot A, resides from 
$A000 to BFFF. If a cartridge is inserted in a slot it will disable any RAM in the same area. 

Slot A, which is present in all models, can reside at the entire 16K used by both cartridges in 
the 800 ($8000 to $BFFF). 

Cartridges use the last six bytes for boot information. In cartridge A these bytes are from 
$BFFA to $BFFF. In cartridge B they are from $9FFA to 9FFF. 



last six bytes of a cartridge 
$9FFA or $BFFA xx start address 

XX 

00 

XX flag byte 
XX init address 
$9FFF or $BFFF xx 

Flag byte 

bit 1 = allow disk boot 

bit 2 = do not start cartridge after init 
bit 7 1 = cartridge takes control before OS is 
initialized 

The initialization process for the cartridge should be similar to that for disk and cassette. A 
minimum of an RTS instruction is required. 

The third byte of the cartridge taller is used by the OS to check for the presence of a 
cartridge. This byte must be zero. 

A 1 6K cartridge will use both cartridge areas and the cartridge B taller area can be used for 
program code. 



THE CARTRIDGE HARDWARE 

Most cartridges consist of two ROM chips on a single circuit board. Moreover, both chip 
sockets have identical pin assignments. In other words, the chips can be switched to 
opposite sockets and the cartridge will still work. The difference is in the chips themselves. 
On one chip, the A12 pin acts as an active-low chip select. On the other the A12 pin acts as 
an active-high chip select. Therefore the state of the A12 pin selects between the two chips. 



Cartridge slot pin assignments 
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mill 








543210987654321 
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FRONT 






1 


1 = 16K 


A 


A13 


(16K only 


2 


A3 


B 


GND 




3 


A2 


C 


A4 




4 


Al 


D 


A5 




5 


AO 


E 


A6 




6 


D4 


F 


A7 




7 


D5 


H 


A8 




8 


D8 


J 


A9 




9 


Dl 


K 


A12 


(CS)/(CS) 





DO 


L 


D3 




1 


D6 


M 


D7 




2 


(CS) 


N 


All 




3 


+Vcc 


P 


AlO 




4 


+Vcc 


R 


NC 




5 


NC 


S 


NC 





The BASIC interpreter resides in the memory used by cartridge A. In 400, 800 and 1200XL 
models, a BASIC cartridge is required to run BASIC programs. On other XL and XE models, 
inserting a cartridge into the slot or pressing the [OPTION] key upon power-up will disable 
the internal BASIC ROM. If BASIC is disabled without inserting another cartridge, the area 
from $A000 to $BFFF will contain RAM. 



Useful data base variables and OS equates 



APPMHI 


$000E, 


2 


(14) 


DOSVEC 


$000A, 


2 


(10) 


DOSINI 


$000C, 


2 


(12) 


CARTB 


$8000 




(32768) 


CARTA 


$A000 




(40960) 


PACTL 


$D302 




(54018) 



low limit of screen region 
run and program reset vector 
init and reset init 
start of cartridge B 
start of cartridge A 
port A control register Bit 
controls the cassette motor 



Go to chapter 1 1 
Go to chapter 13 





CHAPTER 13 
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The Serial Input/Output interface (SIO) 



Most input and output with the Atari computer passes through the serial I/O bus. The SIO 
interface is rather complicated but you are unlikely to need to use it directly. CIO usually 
handles SIO for you. However, if you want to design your own I/O device and it's associated 
handler, you need to know how to use the SIO. 

SIO transfers data at a rate of 19,200 baud on separate input and output lines. The data is 
sent one byte at a time, LSB first, in an asynchronous format. There are also clock-in and 
clock-out lines. There is a signal on the clock-out line but it is not used by any present 
devices. The clock-in line is available for synchronous transfer but is not used by the OS. 
The signal on the clock-out line goes high at the leading edge of each bit and goes low in 
the middle of each bit. 



One byte of SIO data 

+-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ 
I I I I I I I I I I I I I I I I clock 
-+ +-+ +-+ +-+ +-+ +-+ +-+ +-+ + 

+ + + + + 

0|1|0|1 1|0 oil data 
+ + + + + 



I I 

start bit stop bit 

The SIO interface is used much like the resident disk handler. In fact, it uses the same 
device control block as the resident disk handler. After the control block parameters are set, 
a JSR is made to the SIO entry vector, SIOV, at $E459 (58457). 



Device control block (for SIO) 

DDEVIC [$0300 (768)] 

Serial bus I.D. Set by handler or program. 
DUNIT [$0301 (769)] 

Device number if more than one. 
DCOMND [$0302 (770) ] 

Device command byte. 
DSTATS [$0303 (771)] 
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Before the SIO call, this byte tells whether the operation is read, write or that there is no data 
transfer associated with the command. After the call this byte will hold the status (error/no 
error code) of the operation. 



DSTATS format before command 
76543210 
|W|R| not used | 

If both W and R are 0, there is no data transfer. 

DBUFLO [$0304 (772)] 
DBUFHI [$0305 (773)] 

Points to the data buffer for either input or output. 

DTIMLO [$0306 (774)] 

Timeout value (response time limit) in 64/60ths of a second to be set by handler or program. 

DBYTLO [$0308 (776)] 
DBYTHI [$0309 (777)] 

Number of bytes to be transferred, set by handler or program. This parameter is not required 
if the DSTATS specifies no data transfer. 

DAUX1 [$030A (778)] 
DAUX2 [$030B (779)] 

These parameters are sent to the device as part of the command frame. 



USING THE SIO INTERFACE 

All commands on the serial bus must originate from the computer. The peripherals will 
present data on the bus only when commanded to do so. 

Any operation on the serial bus begins with a five byte command frame. 

While the command frame is being sent, the command line of the serial connector is 0. 

Command frame format 
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$xx DDEVIC 

$xx DCOMND 

$xx DAUXl 

$xx DAUX2 

$xx checksum 

The first four bytes of the command frame come from the device control block, the checksum 
is the sum of the other four bytes with the carry added back after each addition. 

If both R and W of the DSTATS are 0, no data is sent to, or expected from the peripheral, 
after a command frame is sent. However, the device is usually expected to send an ACK 
byte ($41) after the command frame is sent. If the command frame is invalid, an NAK byte 
($4E) should be sent. 

If the operation is output (W = 1 ) the computer will send a data frame after it receives the 
ACK of the command frame. It then expects an ACK after the data frame is sent. 

If the operation is an input (R = 1) the computer expects a data frame from the peripheral 
after the ACK. With either input or output, a "complete" code ($43) should be sent to the 
computer when the operation is finished. The "complete" code would follow the ACK of the 
data frame with an output operation. 

If the operation is not completed for some reason, the peripheral should send an error code 
($45) instead of "complete". 



SIO data f 


rame 




byte 


1 


$xx\ 








> 


data bytes 


byte 


n 


$xx/ 




byte 


n+1 


$xx 


checksum 


SIO commands 






READ 


$52 






WRITE 


$57 






STATUS 


$53 






PUT 


$50 






FORMAT 


$21 






DOWNLOAD 


$20 






READADDR 


$54 






READ SPIN $51 






MOTOR ON 


$55 






VERIFY 








SECTOR 


$55 







Present SIO device I.D.s 

DISK $31 - $34 (01 - D4) 
PRINTER $40 
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RS-232-C $50 - $53 (Rl - R4) 



THE SERIAL CONNECTOR 

The serial connectors on the computer and all peripherials are identical. Nearly all 
peripherials have two serial connectors. Either connector may be used for any connection. 
The serial bus is designed so that peripherials can be daisy-chained together. The following 
is a diagram of the serial connector. 



The serial connector pin-out 

1 1 
2 4 6 8 2 

/o o o o o o\ 
/o o o o o o o\ 



13 5 7 9 11 
1 3 



1 clock in (to computer) 

2 clock out 

3 data in 

4 GND 

5 data out 

6 GND 

7 command (active low) 

8 cassette motor control 

9 proceed (active low) 

10 +5V/readY 

11 audio in 

12 +12V (400/800) 

13 interrupt (active low) 



Proceed goes to pin 40 (CA1) of the PIA. It is not used by present peripherials. 
Interrupt goes to pin 18 (CB1) of the PIA. It is not used by present peripherials. 
Pin 1 doubles as a 50mA +5V peripharal power supply and a computer ready signal. 



Useful database variables and OS equates 



SIOV 


$E459 


(58457) 


DDEVIC 


$0300 


(758) 


DUNIT 


$0301 


(759) 


DCOMND 


$0302 


(770) 


DSTATS 


$0303 


(771) 


DBUFLO 


$0304 


(772) 



serial port handler entry 

device ID 

device number 

command byte 

status byte 

data buffer pointer 
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DBUFHI 


$0305 


(773) 




DTIMLO 


$0306 


(774) 


timout value 


DBYTLO 


$0308 


(776) 


number of bytes to transfer 


DBYTHI 


$0309 


(777) 




DAUXl 


$030A 


(778) 


sent to device 


DAUX2 


$030B 


(779) 


sent to device 



Go to chapter 12 
Go to chapter 14 





CHAPTER 14 



The hardware chips 



The previous chapters described the operating system of the computer. The following 
chapters will examine the hardware which supports the 6502 and the hardware's associated 
software. 



THE GTIA CHIP 

The GTIA (George's Television Interface Adapter) is the main video circuit in the computer. It 
controls the following functions. 

GTIA functions: 

• Priority of overlapping objects 

• Color and brightness, including information from the antic chip. 

• Player/missile control. 

• console switches and game control triggers. 



THE ANTIC CHIP 

The main job of the ANTIC chip is interpreting the display buffer for the GTIA chip. The 
ANTIC chip is somewhat of a processor in it's own right. The program which runs it is called 
the display list and usually resides just before the display buffer in memory. 

The ANTIC chip operates independent of the 6502. It operates by direct memory access 
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(DMA). The ANTIC chip gives a HALT signal the 6502, causing the 6502 to give up control of 
the address bus. The ANTIC chip can then read any data it needs to from memory. 

ANTIC chip functions: 

• DMA (Direct Memory Access) control. 

• NMI (Non-Maskable Interrupt) control. 

• LIGHT PEN READING 

• WSYNC (wait for horizontal sync) 



THE POKEY CHIP 

The most important jobs of the POKEY chip are reading the keyboard and operating the 
serial port. It also has the following functions. 

POKEY chip functions: 

• Keyboard reading. 

• Serial port. 

• Pot (game paddles) reading. 

• Sound generation. 

• System timers. 

• IRO (maskable interrupt) control. 

• Random number generator. 



THE PIA CHIP 

The PIA (Parallel Interface Adapter) is a commonly used I/O chip. It consists of two 8 bit 
parallel ports with hand shaking lines. In the Atari, it has the following functions: 

• Game controller port control (bi-directional). 

• Peripheral control and interrupt lines. 

Registers in the hardware chips are treated as memory addresses. Many of the registers are 
write only. These registers cannot be read from after they are written to. Other registers 
control one function when written to and give the status of an entirely different function when 
read from. Still other registers are strobes. Any command which causes the address of one 
of these registers to appear on the address bus will cause their functions to be performed. 

The write only registers have shadow registers in RAM. Data to be put in the registers is 
usually put into the shadow registers. The data in the shadow registers is automatically 
moved to the operating registers during vertical blank. 
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For register use and address, see the previous chaptes on the associated functions. 



Go to chapter 13 
Go to chapter 15 





CHAPTER 15 

Display Lists 



[some of this file was lost...] 

chip also has a memory scan counter. This register scans the display buffer for data to be 
interpreted and displayed. Once loaded, the memory scan counter's 4 most significant bits 
are fixed. The result is that the memory scan counter cannot cross a 4K memory boundary 
(i.e. $AFFF to $B000) without being reloaded. 



DISPLAY LIST INSTRUCTIONS 

There are three basic instructions in the display list. The type of instruction is determined by 
bits 0,1 ,2 and 3 of an instruction byte. The other four bits give auxilliary parameters for the 
instruction. Bit 7 always enables a display list interrupts (DLIs). 



Display list instruction format 

76543210 

|I|n|n|n|0|0|0|0| 

\ / \ / 

I 1 

I = display blank lines 

I 

0-7 = number of blank lines (1-8) 

76543210 
|I|W| I JOIOIOUI 
I \ / 
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1 = jump (3 byte instruction) 

jump and display one blank line 
jump and wait for vertical blank 



76543210 
|I|R|H|ViMlM|MlM| 
\ / 

I 



2-F = display one line of graphics in 
ANTIC mode 2-F 
1 = horizontal scroll enabled 



1 = vertical scroll enabled 
1 = reload memory scan counter with next two bytes 
1 = display list interrupt, all instructions 



In the display instruction, the ANTIC mode is different from the CIO graphics mode. 
However, each CIO graphics mode uses a particular ANTIC mode. Below are descriptions of 
the ANTIC modes with their associated graphics (CIO) modes. 

ANTIC MODE 2 (Graphics 0) 

Uses 8 pixel by 8 pixel characters, 40 characters horizontal, 8 TV scan lines vertical. Only 
one color can be displayed at a time. 

ANTIC MODE 3 

8X10 pixel, Graphics type characters. This mode requires a custom character set. The 
advantage is that it allows true decenders. The custom C-set is still 8X8 pixels. 
Lower-case letters with decenders have the bottom row of pixels put on the top row. 



Lower-case "y" for ANTIC mode 3 
C-set Display 



1 XXXXX 1 




1 XX XX 1 


1 XX XX 1 


1 XX XX 1 


1 XX XX 1 


1 XX XX 1 


1 XX XX 1 


1 XXXXX 1 


1 XXXXX 1 


1 XX 1 


1 XX 1 




1 XXXXX 1 
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ANTIC MODE 4 (graphics 12 on XL and XE) 

This mode has characters the same size as graphics 0. However, the characters are only 4 
X 8 pixels. This gives only half the horizontal resolution of graphics 0. The advantage is that 
up to four colors of "graphics 0" characters can be displayed at once. This mode also 
requires a custom C-set. Below is a comparison of the normal C-set to one which works 
with the ANTIC 4 mode. 



Upper-case "A" for ANTIC modes 2 and 4 
mode 2 mode 4 



1 XX 1 


1 YY 1 


1 XXXX 1 


1 YY 1 


1 XX XX 1 


1 XX zz 1 


1 XX XX 


1 XX zz 1 


1 XXXXXX 1 


Ixxyyzz | 


1 XX XX 1 


1 XX zz 1 



XX, yy and zz represent two bit binary numbers, controlling one pixel each. These numbers 
determine which color register a pixel is assigned to: (COLORO, C0L0R1 , C0L0R2 or 
COLORS). 

ANTIC mode 5 

Antic mode five is identical to ANTIC mode 4 except the characters are displayed twice as 
tall. This makes only 12 lines on the screen. 

ANTIC MODE 6 (Graphics 1) 

This mode uses 8X8 pixel characters except they are displayed twice as wide as in ANTIC 
mode 2. There are 3 colors available at once but only one case (upper or lower) can be 
displayed at a time. The data base variable CHBAS [$02F4 (756)] controls the character, 
[$E0 (224) = upper-case, $E2 (226) = lower-case] 

The color/character is controlled by either the color statement or the AT ASCII number of the 
character printed. Control characters are controlled by COLORO, upper-case characters by 
C0L0R1 and lower-case characters by C0L0R2. Remember that all characters print as 
upper-case alpha characters, but of different colors. 

ANTIC MODE 7 (Graphics 2) 

This mode is identical to mode 6 except the characters are displayed twice as tall. This 
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results in only 12 lines possible on the screen. 

ANTIC MODE 8 (Graphics 3) 

This is the first graphics (non-character) mode. This mode, as other non-character graphics 
modes do, uses data in the display buffer as a bit map to be displayed. 

A command to display in mode 8 will cause the ANTIC chip to read the next 10 bytes in the 
display buffer. Each pair of bits will control one pixel as in mode 4. However, the pixels are 
blocks the same size as a Graphics (ANTIC 2) characters. 

ANTIC MODE 9 (Graphics 4) 

This is similar to ANTIC mode 8 except each byte controls 8 pixels (instead of 4) and only 
one color can be displayed at a time. The pixels are also half the size of those in ANTIC 
mode 8. 

ANTIC MODE A (Graphics 5) 

This mode uses 20 bytes per line/command. As in ANTIC mode 8, each pair of bits controls 
one pixel. The result is that the pixels are the same size as in ANTIC mode 9 but four colors 
can be displayed at once. 

ANTIC MODE B (Graphics 6) 

As in mode A, there are 8 pixels per byte and only one color. The pixels are half the size as 
in mode A. 

ANTIC MODE C 

Like mode B except the pixels are half as tall (only one T.V. line). 

ANTIC MODE D (Graphics 7) 

40 Bytes per line, each byte controls 4 pixels. The pixels are 1/4 as large as in ANTIC mode 
8 (Graphics 3). 

ANTIC MODE E (Graphics 15 on XL andXE) 

Like mode D except the pixels are half as tall (one T.V. line). Antic mode E is sometimes 
called Graphics 7.5 

ANTIC mode F (Graphics 8,9, 10 and 1 1) 

This is the highest resolution mode. Pixels are 1/8 the size of ANTIC mode 8 or mode 2 
characters. It uses 40 bytes per line, each byte controlling 8 pixels, unless the GTIA chip 
intervenes. Only one color can be displayed at a time. 
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DISPLAY LIST EXAMPLES 

When CIO opens a channel to the screen, it sets up the proper display list for the ANTIC 
chip. The following are the things CIO must handle when setting up the display list. 

Display list duties as used by CIO : 

• display a certain number of blank lines at the top of the screen. 

• Load the memory scan counter with the address of the display data buffer. 

• Display the required number of lines in the required ANTIC mode. 

• Set up a jump instruction if the display list crosses a 1 K memory boundary. 

• Set up a reload-memory-scan-counter instruction if the display data buffer crosses a 
4K memory boundary. 

CIO assumes that the display data buffer will butt against an 8K memory boundary. If a 
program causes the display buffer to cross a 4K boundary (by changing RAMTOP [$006A 
(106)] to point to an address which is not at an 8K boundary) the screen will be scrambled. 
This is not usually a problem if the graphics mode doesn't require a large block of memory. 



SAMPLE DISPLAY LIST 

Below is an example of a Graphics display list as CIO would set it up. 



Display list for Graphics 
assuming BASIC starts at $A000 

address instruction explanation 

Dec. Hex. 

$9C20 112 $70 \ 

112 $70 > 24 blank lines (8 each command) 

112 $70 / 

66 $42 load memory scan counter with 

$9C24 64 $40 \ next two bytes and display one line 

156 $9C / \ of ANTIC 2 characters 

2 $02 -\ I 

2 $02 I \- address of display data buffer 

2 $02 I 

2 $02 \ 2nd ANTIC 2 instruction 



2 $02 24th ANTIC 2 instruction 

65 $41 \ 

32 $20 > jump back to start of list 
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156 $9C / 
$9C40 ??? ?? first byte of display data buffer 



$9FFF ??? ?? last byte of buffer 
$A000 start of ROM 

A display list for a higher resolution graphics mode would require more instructions and 
might cross a 1 K boundary. It would then include a jump instruction to cross the boundary. 



MULTIPLE DISPLAYS 

It is possible to set up multiple displays and use one at a time. The technique of changing 
from one display to another is called page flipping. Below is the simplest way to set up two 
displays. 

Setting up two displays: 

• Call a graphics mode through CIO or by using a BASIC GRAPHICS command. 

• Store the display list pointers, SDLSTL and SDLSTH, and the CIO screen pointer, 
SAVMSC [$0058,2 (88)]. 

• Move the start-of-ROM pointer, RAMTOP [$006A (106)] to below the current display 
list. RAMTOP is a one byte pointer so it changes in increments of one page (256 
bytes). 

• make another graphics call as in the first step. 

• store the new display list pointer and CIO screen pointer. 

This will set up two displays, each with it's own display list. If the displays are in the same 
graphics mode, or you will not make any changes in the displays with CIO commands, 
(PLOT, PRINT, etc.) you can flip between the two simply by changing the display list pointer. 

If the screens are in the same graphics mode and you want to change which one to do CIO 
commands to. Change the CIO screen pointer, SAVMSC [$0058,2 (88)]. This way, you can 
display one screen while drawing on the other. 

If you want to do CIO commands to screens of different graphics modes, you will have the 
move RAMTOP and do a graphics call to change screens. 

If your manipulation of RAMTOP causes the display data buffer to cross a 4K boundary, the 
screen may be scrambled. 
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DISPLAY LIST INTERRUPTS 

DLIs are not used by the operating system. However, other programs can initiate and use 
them. Use the following steps to set up display list interrupts. 

Setting up DLIs: 

• Set bit 7 of the display list instruction for the line before you want the interrupt to occur. 
(The interrupt routine should set WSYNC and wait for the next line to execute.) 

• Set bit 7 of NMIEN [$D40E (54286)] to enable DLIs. 

• Set the DLI routine vector, VDSLST [$0200,2 (51 2)] to point to your machine language 
DLI routine. 

• Your DLI routine should set WSYNC [$D40A (54282)]. STA WSYNC will do. THis will 
cause the 6502 to wait for the next horizontal sync. This will keep the DLI routine from 
changing something in the middle of a T.V. line. 

• The DLI routine must end with an RTI instruction. 



SCROLLING 

Scrolling is controlled by a combination of scroll position registers, and changing the memory 
scan counter. Basically, course scrolling is done by reloading the memory scan counter and 
fine scrolling is done by changing the scroll registers. 



VERTICAL SCROLLING 

Vertical scrolling is very simple. Follow the steps below to set up vertical scrolling of 
graphics. 

Steps to use vertical scrolling: 

• Set bit 4 of the first byte of the display list instruction for each line to be scrolled. 

• Put the number of T.V. lines to offset the graphics vertically in the vertical scroll 
register, VSCROL [$D405 (54277)] 

• The vertical scroll register can offset the graphics upward by - 7 T.V. lines in the 24 
line graphics modes (ANTIC modes 2 and 4). In 12 line graphics modes (ANTIC 
modes 5 and 7) it can vertically offset the graphics by - 15 T.V. lines. To offset the 
graphics an 8th (or 16th) line, the scroll register is reset to and the memory scan 
counter is reloaded with the address of the next line of graphics in the display data 
buffer. If the entire screen is being scrolled, the load-memory-scan-counter command 
(near the beginning of the display list) is changed to point to the address of the second 
line of graphics. 
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HORIZONTAL SCROLLING 

Horizontal scrolling works much like vertical scrolling. It is enabled by setting bit 5 of the 
instruction for each line to be scrolled. The horizontal scroll register, HSCROL [$D404 
(54276)], sets the offset. The small difference is that graphics are moved twice as far per 
change (two graphics 8 pixels instead of one). Also, when HSCROL = the graphics are 
offset beyond the left edge of the screen by 16 color clocks (32 Graphics 8 pixels). When 
HSCROL = 15, the graphics line is shifted one color clock (2 Graphics 8 pixels) to the left of 
the screen. 

The big difference is that the memory scan counter gets messed up. This means that you 
must use a reload-memory-scan-counter command for each line of graphics. This is a 
major modification of the display list. It will require you to move and build the list yourself. 

The advantage of this is that you can have a scrolling window in a large graphics map. The 
technique is to move the window by reloading the memory scan counter, then fine scrolling 
to the invisible bytes beyond the edges of the screen. 



useful data base variables and OS equates 



SAVMSC 


$0058,2 


(88) 


RAMTOP 


$006A 


(106) 


VDSLST 


$0200,2 


(512) 


RAMS I Z 


$02E4 


(740) 


DLISTL 


$D402 


(54274) 


DLISTH 


$D403 


(54275) 


HSCROL 


$D404 


(54276) 


VSCROL 


$D405 


(54277) 


NMIEN 


$D40E 


(54286) 



pointer to current screen for CIO commands 

start-of-ROM pointer (MSB only) 

DLI vector 

permanent start-of-ROM pointer (MSB only) 

display list pointer low byte 

" high byte 
horizontal scroll register 
vertical scroll register 
NMI enable (DLIs) 



Shadow registers 



SDLSTL $0230 
SDLSTH $0231 



(560) : DLISTL 
(551) : DLISTH 



Go to chapter 14 
Go to chapter 16 





CHAPTER 16 
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Player and Missile (PM) Graphics 



Players and missiles (called sprites on some computers) are movable objects which are 
independent of the normal graphics. 

Player and missile graphics are fairly straight forward. Once the computer is set-up for PM 
graphics, five 8-pixel-wide columns can be displayed on the screen. The horizontal 
resolution (width of each pixel) and the vertical resolution (number of scan lines per pixel) are 
variable. The horizontal position of each column is determined by it's horizontal position 
register. Each column is simply a representation of a bit map in a certain block of memory. If 
you want to draw an object on the screen, you simply put a bit map representing it in the 
proper memory block. The vertical position of an object is determined by the location of it's 
bit map in memory. For example, if you want to draw a happy face in the middle of the 
screen, you put a happy face bit map in the middle of one of the memory blocks controlling 
one of the columns. 



One column (player) displayed on the screen 
first byte of a block 



++++ 

+ + 

+ + + + I 

+ + 1 

++ ++ 1 

+ ++++ + I 

+ + 

++++ 



visible 



-object 
bit map 



last byte of a block 



Horizontal positions 



$00 $30 
(0) (48) 

I I 

I Left edge 

I 



$CE $FF 
(206) (255) 
I I 
right edge | 
I 
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Far left far right 

To move the happy face vertically you would move the entire bit map in memory. To move 
the happy face horizontally you change the number in the horizontal position register for the 
proper player. 

One of the players can be (and often is) split into four columns of two pixels wide each. 
These columns are then called missiles. In this case, each missile has it's own horizontal 
position register. 



SETTING UP PM GRAPHICS 

PM graphics are enabled by the direct memory access control register, DMACTL [$D400 
(54272)]. The program using PM graphics will usually use the shadow register, SDMCTL 
[$022F (559)]. 



DMACTL (SDMCTL) 

76543210 
10101 control | 



5 


1 


4 







1 


3 


1 


2 


1 





00 




01 




10 




11 



bits 

enable display list reading 
one line player resolution 
two line player resolution 
enable four players 
enable fifth player or missiles 
1 & 00 = no background 

narrow background (128 color clocks, 
1 color clock equals 2 GRAPHICS 8 pixels) 
normal background (160 color clocks) 
wide background (192 color clocks) 

Normally, bits 5 and 1 are set to 1 . Bits 4, 3 and 2 are used to enable players and/or missiles 
accordingly. 

Once DMACTL is set up for the type of PM graphics to enable, the graphics control register, 
GRACTL [$D01 D (53277)], is used to actually enable the PM graphics. 



GRACTL 
76543210 
I not used I I I I 
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Bits 

2 1 = latch paddle triggers 

1 1 = enable four players 

1 = enable fifth player or missiles 

If only DMACTL is set up, the ANTIC chip will access memory for PM graphics but will not 
display them. 

Next, the memory area used for the PM bit maps must be set. This block must start on a 2K 
(8 page) boundary if single line resolution is used and a 1 K (4 page) boundary for two line 
resolution. 

The page number where the bit map starts is stored in the PM base register, PMBASE 
[$D407 (54279)]. For one line resolution this number will be a multiple of 8. For two line 
resolution it will be a multiple of 4. PMBASE holds the MSB of the address of the PM bit 
map. The LSB will always be so it need not be specified. 



The PM bit maps 

2 line resolution 
128 bytes (1/2 page) 
per player 

start + 

I l\ 

+ h 1-1/2 page 

I I (384 bytes) 

+===============+ unused 

I 1/ 

+ + +$180 (384) 

|M3 tM2 iMl |M0 I fifth player or missiles 
+===============+ +$200 (512) 

I player map | 

+ + +$280 (640) 

I player 1 map i 
+===============+ +$300 (768) 

I player 2 map | 

+ + +$380 (896) 

I player 3 map i 
+===============+ +$400 (1024) 

1 line resolution 
256 bytes (1 page) 
per player 



start + 

I l\ 

+ + 

I I 

I I 768 bytes 

+ + 
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I I (3 pages) 

I I unused 

+ + 

I 1/ 

+===============+ +$300 (768) 

I I I I I fifth player 
+M3 |M2 |M1 |M0 I or missiles 
I I I I I 
+===============+ +$400 (1024) 

I I 

+ player map + 

I I 

+===============+ +$500 (1280) 

I I 

+ player 1 map + 

I I 

+===============+ +$500 (1536) 

I I 

+ player 2 map + 
I I 

+===============+ +$700 (1792) 

I I 

+ player 3 map + 

I I 

+===============+ +$800 (2048) 



Example of using P/M graphics in BASIC 

REM LABEL REGISTERS ETC 

10 LINES=2 

20 VERT=120 

22 IF LINES=2 THEN VERT=VERT/2 

30 PM0=1024 

32 IF LINES=2 THEN PM0=PM0/2 

40 HORIZ=120 

50 PCOLR0=704 

60 SDMCTL=559 

70 SIZEP0=53256 

80 HPOSP0=53248 

90 SDMCTL=559 

100 PMRAM=PEEK(10 6)-16 

110 PMBASE=54279 

120 GRACTL=53277 

130 PMSTART=PMRAM*256+PM0 

200 REM SET REGISTERS 

210 POKE SDMCTL, 62 

212 IF LINES=2 THEN POKE SDMCTL, 46 

220 POKE SIZEPO,! 

230 POKE HPOSP0,HORIZ 

240 POKE PCOLRO, 88 

250 POKE PMBASE,PMRAM 

2 60 POKE GRACTL,3 

300 REM DRAW PLAYER 

310 POKE PMSTART+VERT, 60 
320 POKE PMSTART+VERT + 1, 6 6 
330 POKE PMSTART+VERT + 2, 165 
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340 POKE PMSTART+VERT + 3, 129 

350 POKE PMSTART+VERT + 4, 195 

360 POKE PMSTART+VERT+5, 189 

370 POKE PMSTART+VERT+6, 6 6 

380 POKE PMSTART+VERT + 7, 60 



The above program will draw a happy face in about the middle of the screen using player 0. 
To move the player horizontally, poke a different number into HPOSPO. To draw the player in 
a different vertical position, change VERT. To use a different player or missile, use the 
memory maps above to find the starting address of the player you want to use. For example, 
to use player 1 change line 40 to PM1=1280. Then change line 130 to 
PMSTART=PMRAM*256+PM1 . The variable "LINES" determines the vertical resolution. The 
number poked into SIZEPO determines the width. 



P/M PRIORITY 

The priorities of players, missiles and non-P/M graphics can be controlled by the PRIOR 
register [$D10B (53275)] and its shadow register, GPRIOR [$26F (623)]. Objects with higher 
priority will appear to move in front of lower priority objects. The format of PRIOR is as 
follows: 



PRIOR bit assignment 
76543210 

I I I I I I I I I 

16318421 

2 4 2 6 

8 

Bits 

7-5 Control the GTIA graphics modes. 

00 = normal 

01 = mode 9 

10 = mode 10 

11 = mode 11 

5 1 = multiple color player enable. Permits 
overlapping of players and 1 or 
2 and 3 with a third color in the 
overlapped region. 

4 1 = fifth player enable. All missiles 
will assume the color controlled by 
C0L0R3 [$2C7 (711)]. missiles are 
positioned together to make the fifth 
player. 
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3-0 Controls the priorities of players, missiles 
and other graphics. Objects with higher priority will appear to move 
in front of those with lower priority. 

The following chart may need some clarification. In the chart: 



PMO = player and missile 

CO = COLORO, plotted graphics controlled 
by color register in the SETCOLOR 
command. 

P5 = all four missiles when combined 
into one player. 

BAK = the background, known as C0L0R4 or color 
register 4 in the SETCOLOR command. 



Etc. 



3its 0-3 of PRIOR and P/M priorities 



Bit 3=1 2=1 1=1 0=1 



CO 


CO 


PMO 


PMO 


highest 


01 


01 


PMl 


PMl 


priority 


PMO 


02 


OO 


PM2 




PMl 


03+P5 


01 


PM3 




PM2 


PMO 


02 


OO 




PM3 


PMl 


03+P5 


01 




02 


PM2 


PM2 


02 




C3+P5 


PM3 


PM3 


03+P5 


lowest 


BAK 


BAK 


BAK 


BAK 


priority 



Only one priority bit can be set at a time. If more than one priority bit is 1 , overlapping areas 
of conflicting priorities will turn black. 



COLLISIONS 

Each player or missile has a register showing overlap (collisions) with other objects. Each 
player has two registers assigned to it; one to detect collisions with other players and one to 
detect collisions with plotted objects. Likewise each missile has two registers; one to detect 
collisions with players and one to detect collisions with plotted objects. Careful use of these 
1 6 registers can detect any type of collision. 

Each register uses only the lower 4 bits. The bits which equal 1 tell what the associated 
object has collided with. For example, to detect collisions of player 1 to other players 
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examine PI PL [$DOOD (53261)]. 



PIPL, player 1 to player collisions 

76543210 

PIPL I unused I [ I I I 

8 4 2 1 

3=1 collision with player 3 

2=1 collision with player 2 

1=1 invalid 

0=1 collision with player 

Etc. 



When looking for collisions with plotted objects, the bit number tells what color register is 
assigned to the object the collision was with. For example, to detect collisions between 
player 1 and plotted objects (officially called the play field), PI PF [$D005 (53253)] is used. 



PIPF, player 1 to ploted object collisions 

76543210 

PIPF I unused I I I I I 

8 4 2 1 

3=1 collision with C0L0R3 

2=1 " C0L0R2 

1=1 " COLORl 

0=1 " COLORO 

Etc. 



Once a collision occurs it remains indicated in its collision register. To clear out all collision 
registers, write anything to HITCLR [$D01E (53278)]. STA HITCLR or POKE 53278,0 will do. 



Useful database variables and OS equates 



HPOSPO 


$D000 


(53248) 


write 


hori 


MOPE 


II 


n 


read: 


missi 


HPOSPl 


$D001 


(53249) 


write 


hori 


MIPF 


II 


n 


read: 


missi 


HP0SP2 


$D002 


(53250) 


write 


hori 


M2PE 


II 


n 


read: 


missi 


HP0SP3 


$D003 


(53251) 


write 


hori 


M3PE 


II 


n 


read: 


missi 


HPOSMO 


$D004 


(53252) 


write 


hori 


POPE 


II 


n 


read: 


Playe 


HPOSMl 


$D005 


(53253) 


write 


hori 



-zontal position of player 

-le to plotted graphics collisions 

-zontal position of player 1 

-le 1 to plotted graphics collisions 

-zontal position of player 2 

-le 2 to plotted graphics collisions 

-zontal position of player 3 

-le 3 to plotted graphics collisions 

-zontal position of missile 

;r to plotted graphics collisions 

-zontal position of missile 1 
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PIPF 


II 


HP0SM2 


$D006 


P2PF 


II 


HP0SM3 


$D007 


P3PF 


II 


SIZEPO 


$D008 


MOPL 


II 


SIZEPl 


$D009 


MIPL 


II 


SIZEP2 


$DOOA 


M2PL 


II 


SIZEP3 


$DOOB 


M3PL 


II 


SIZEM 


$DOOC 


POPL 


II 


GRAFPO 


$DOOD 


PIPL 


II 


GRAPE 1 


$DOOE 


P2PL 


II 


GRAF P 2 


$DOOF 


P3PL 


II 


GRAPE 3 


$D010 


GRAFM 


$D011 


COLPMO 


$D012 


COLPMl 


$D013 


C0LPM2 


$D014 


C0LPM3 


$D015 


COLPFO 


$D016 


COLPFl 


$D017 


C0LPE2 


$D018 


C0LPF3 


$D019 


COLBK 


$D01A 


PRIOR 


$D01B 


GRACTL 


$D01D 


HITCLR 


$D01E 


DMACTL 


$D400 


PMBASE 


$D407 



(53254) 

n 

(53255) 

n 

(53256) 

n 

(53257) 

n 

(53258) 

n 

(53259) 

n 

(53260) 

n 

(53261) 

II 

(53262) 

n 

(53263) 

n 

(53264) 
(53265) 
(53266) 
(53267) 
(53268) 
(53269) 
(53270) 
(53271) 
(53272) 
(53273) 
(53274) 
(53275) 
(53277) 
(53278) 
(54272) 
(54279) 



read: Player 1 to plotted graphics collisions 

write: horizontal position of missile 2 

read: Player 2 to plotted graphics collisions 

write: horizontal position of missile 3 

read: Player 3 to plotted graphics collisions 

write: size of player 

read: missile to player collisions 

write: size of player 1 

read: missile 1 to player collisions 

write: size of player 2 

read: missile 2 to player collisions 

write: size of player 3 

read: missile 3 to player collisions 

write: widths for all missiles 

read: player to other player collisions 

write: player graphics (used by OS) 

read: player 1 to other player collisions 

write: player 1 graphics 

read: player 2 to other player collisions 

write: player 2 graphics 

read: player 3 to other player collisions 

write : player 3 graphics 

write: missile graphics (used by OS) 

color for player/missile 

color for player/missile 1 

color for player/missile 2 

color for player/missile 3 

color register 

color register 1 

color register 2 

color register 3 

background color (register 4) 

priority select, GTIA modes 

graphics control 

writing anything clears all collision bits 

direct memory access (DMA) control 

start of P/M memory 



Shadow registers 



SDMCTL 


$022F 


(559) 


DMACTL 


GPRIOR 


$026F 


(623) 


PRIOR 


PCOLRO 


$02C0 


(704) 


COLPMO 


PCOLRl 


$02C1 


(705) 


COLPMl 


PC0LR2 


$02C2 


(706) 


C0LPM2 


PC0LR3 


$02C3 


(707) 


C0LPM3 


COLORO 


$02C4 


(708) 


COLPFO 


COLORl 


$02C5 


(709) 


COLPFl 


C0L0R2 


$02C6 


(710) 


C0LPE2 


C0L0R3 


$02C7 


(711) 


C0LPF3 


C0L0R4 


$02C8 


(712) 


COLBK 



Go to chapter 15 
Go to chapter 17 
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CHAPTER 17 

Sound 



Generating sound can be very simple. For simple sounds there are four audio channels, 
each controlled by two control registers. 



GENERATING SOUNDS 

To generate a sound in channel 1 , put the frequency and volume codes into the frequency 
and control registers. The frequency register for channel 1 , AUDF1 [$D200 (53760)] can 
have any number from to $FF (255). causes the highest frequency; 255 causes the 
lowest. The volume/noise (control) register for channel 1, AUDC1 [$D201 (53761)] is more 
complicated. 



Audio channel control (volume/noise) register 
76543210 
AUDCx I noise | volume I 



16318421 
2 4 2 6 



The noise bits can have various values. The best way to learn to use them is by 
experimentation. The technical details of the polynomial counters which generate the noise 
has little bearing on what is heard. The two special values of interest are: $1 (volume+16 in 
decimal), which causes a DC voltage proportional to the volume bits and; $A (volume+160), 
which causes a pure tone (square wave). The volume bits select the relative volume, O=off. 
Therefore, the number, $A8 (168 [8+160]) in AUDC1, will cause the frequency selected by 
AUDF1 to be a pure tone of medium volume. 

In BASIC the dirty work is done fore you. The SOUND command will do all the calculations 
for you. The Sound command format is shown below. 

The BASIC sound command format 



SOUND channel, frequency, noise, volume 
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The channel numbers is to 3 instead of 1 to 4. The frequency, to 255, is put into the 
frequency register. The noise is put into the high bits of the channel control register with 
volume in the low bits. Therefore... 



SOUND 0,125,10,8 

will produce a pure tone of medium frequency and volume in channel (called channel 1 in 
assembly language). 



ADVANCED SOUND 

The Audio Control register, AUDCTL [$D208 (53768)], (not to be confused with the four 
audio channel control registers), adds more control for assembly language programmers. 
Again, to go into technical details will be less productive than experimentation. 



The audio control register. (AUDCTL) 
76543210 



AUDCTL I I I I I I I 



16318421 
2 4 2 6 



7 = 17 bit polynomial noise 

1 = 9 bit below polynomial noise 
6 = clock channel 1 with 64 KHz 

1 = clock channel 1 with 1.79 MHz 
5 = clock channel 3 with 54 KHz 

1 = clock channel 3 with 1.7 9 MHz 
4 = clock channel 2 with 64 KHz 

1 = clock channel 2 with channel 1 
3 = clock channel 4 with 64 KHz 

1 = clock channel 4 with channel 3 
2 1 = insert logical high-pass filter in 

channel 1, clocked by channel 3 
1 1 = insert logical high-pass filter in 

channel 2, clocked by channel 4 
= 64 KHz main clock 

1 = 16 KHz main clock 

All bits of AUDCTL are normally zero. The BASIC sound command causes it to be reset to 
zero. 

By clocking one channel with another, the range can be increased. This essentially allows 
two channels with twice the range as each of the four normal channels. This is called 16 bit 
sound. 
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To calculate exact frequencies, use the following formulas. The exact clock frequencies are 
also given if more accuracy is needed. The clock frequencies are acquired by dividing the 
signal from the TV color-burst crystal. This crystal has a frequency of 3.579545 MHz. 



Clock frequencies: 
1.7897725 MHz (oolor-burst/2) 
63.920446 Khz (color-burst/56) 
15.699759 KHz (color-burst/228) 

Formulas : 

For 1.79 MHz 

clock clock 
f = f = 



2 (AUDFn + 7) 2 (AUDFn + 4) 

16 bit 8 bit 

AUDFn is the number in the audio frequency register. 

For 15 KHz and 54 KHz 



clock 

f = 

2 (AUDFn + 1) 



AUDIO TIMER INTERRUPTS 

When the audio timers count down to zero they generate IRQ interrupts (if enabled). The 
timers can be reset by writing any number to STIMER [D209 (53769)]. 



THE CONSOLE SPEAKER 

The console speaker is where key clicks and the cassette signals come from. On XL and XE 
models this speaker is heard through the TV speaker. It is operated by toggling bit 3 of 
CONSOL [$D01 F (53279). This bit always reads but it is actually set to 1 during vertical 
blank. 
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Useful data base variables and OS equates 



CONSOL 


$D01F 


(53279) 


AUDFl 


$D200 


(53760) 


AUDCl 


$D201 


(53751) 


AUDF2 


$D202 


(53762) 


AUDC2 


$D203 


(53763) 


AUDF3 


$D204 


(53764) 


AUDC3 


$D205 


(53765) 


AUDF4 


$D206 


(53766) 


AUDC4 


$D207 


(53767) 


AUDCTL 


$D208 


(53768) 


STIMER 


$D209 


(53769) 



bit 3 controls console speaker 

Audio frequency 1 

audio control 1 

Audio frequency 2 

audio control 2 

Audio frequency 3 

audio control 3 

Audio frequency 4 

audio control 4 

general audio control 

audio timer reset 



Go to chapter 16 
Go to chapter 18 





CHAPTER 18 



The joystick ports 



The joystick ports are the I/O ports of the PIA chip. This means that they are bidirectional, 
capable of output as well as input. The joystick ports are usually set up for input. To read 
them, simply read the port registers. PORTA [$D300 (53016)] will read joystick ports 1 and 2. 
PORTB [$D301 (5401 7)] will read joystick ports 3 and 4. Joystick ports 3 and 4 are used for 
memory control on the XL/XE models and don't have external connectors. 

Each bit of each port can be configured independently for input or output. To reconfigure a 
port, the port control registers, PACTL and PBCTL [$D302 (54018) and $D303 (54019)], are 
used. The port control registers also control some lines on the serial I/O connector. 





The 


port 


control 


registers 




7 


6 


5 


4 


3 


2 1 







PACTL 





-- 


— - 


— - 


— - 





— - 




or 


In 





1 


1 


n 


n 


n 




PBCTL 





-- 


— - 


— - 


— - 





— - 






1 


6 


3 


1 


8 


4 2 


1 






2 


4 


2 


6 











bits 



PACTL 
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7 Peripheral A interrupt status. Set by peripheral 

interrupt; reset by reading PORTA. 
3 Cassette motor control (0 = on: 1 = off) . 

2 = PORTA is now port A direction control. 

Writing to PORTA will now set bits for input 
or output . 

sets bit for input; 1 sets bit for output. 

1 = PORTA operational 

1 1 = peripheral A interrupt enabled. 

PBCTL 

7 Peripheral B interrupt status. Set by peripheral 
interrupt; reset by reading PORTE. 

3 Serial connector command line. 

2 = PORTB is now port B direction control. 

Writing to PORTB will now set bits for input 
or output . 

sets bit for input; 1 sets bit for output. 

1 = PORTB operational 

1 1 = peripheral B interrupt enabled. 

The electronic configuration of the controller ports is as follows. 



\0 1 2 3 R/ \4 5 6 7 R/ 

\t + - L/ \t + - L/ 



through 7 are the binary data bits for port A or port B. 

+ and - are +5 volts and ground respectively. 

R and L are the left and right game paddles. 

t is the joystick trigger line. 

The data bits in the joystick ports are used as follows for the joysticks and game paddles. 

The joysticks and the port registers 
76543210 
PORTA |U|D|L|R|U|D|L|R| 



16318421 
2 4 2 6 



paddle | | | | 
triggers 3 2 10 
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PORTB 







(400/800 
only) 


|U|D|L!R|U|D|L|R| 






paddle 


1 1 


1 1 


triggers 


7 6 


5 4 


U = 


up 




D = 


down 




L = 


left 




R = 


right 





The joysticks may be read either directly from the port registers or from the joystick shadow 
registers. During vertical blank, the data in the port registers is separated and put into the 
shadow registers. These registers are, STICKO [$0278 (632)], STICK1 [$0279 (633)], 
STICK2 [$027A (634)] and STICK3 [$027B (635)]. The triggers may be read from the joystick 
trigger registers, TRIGO - TRIG3 [$D010 - $D013 (53264 - 53267)]. These register have 
shadow registers, STRIGO - STRIG3 [$0284 - 0287 (644 -647)]. If these registers read zero 
the associated triggers are pressed. The paddle triggers may be read from their shadow 
registers also. They are, PTRIGO - PTRIG 7, [$027C - $0283 (236 - 643)]. 



THE GAME PADDLE REGISTERS 

Although the game paddles are plugged into the joystick ports, they are not read from the 
port registers. The game paddles are read by first writing any number to the start-pot-scan 
register, POTGO [$D20B (53771)]]. This turns off the capacitor dump transistors and allows 
the pot reading capacitors to begin charging. It also sets the TV scan line counter to zero. As 
each capacitor crosses a certain trigger voltage, the number of TV lines scanned is put in the 
respective pot value register. When the scan counter reaches 228, the capacitor dump 
transistors are turned on and the number 228 is put into any pot value registers which are 
still empty. 

Before reading the pot value registers, ALLPOT [$D208 (53768)] should be checked. In this 
register, each bit corresponds to the validity of a pot value register. If a bit is zero, its' 
associated pot value register is valid. If bit 2 of SKCTL, [$D20F (53775)], is 1 , the pots go 
into the fast scan mode. In this mode the paddles are read in only 2 TV scan lines. They can 
also be read without regard to POTGO or ALLPOT. 

The pot value registers contain the number of TV scan lines it last took for the paddle 
reading capacitors to charge (up to 228). These registers are POTO - P0T7 [$D200 - $D207 
(53760 -53767)]. Their shadow registers are PADDLO - PADDL7 [$0270 - $0277 (624 - 
631)]. 
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THE LIGHT PEN REGISTERS 

Whenever a joystick trigger is pressed, the light pen registers, PENH and PENV are 
updated. PENH [$D40C (54284)] takes a value based on a color clock counter. The value 
can be from to 227. PENV [$D40D [54285)] takes the 8 highest bits of the vertical line 
counter. A light pen is simply a photo transistor connected to a joystick trigger line and 
focused on the TV screen. When the electron beam strikes the part of the screen the light 
pen is focused on, the transistor turns on pulling the trigger line low. The light pen registers 
then contain numbers relative to where the light pen was pointing. The shadow register for 
PENH and PENV are LPENH [$0234 (564)] and LPENV [$0235 (566)). 



Useful operating system equates 



TRIGO 


$D010 


(53264) 


joystick triggers 


TRIGS 


$D013 


(53268) 




POTO 


$D200 


(53760) 


paddle value 


P0T7 


$D207 


(53767) 




ALLPOT 


$D208 


(53768) 


reads validity of pot values 


POTGO 


$D20B 


(53771) 


starts paddle read 


SKCTL 


$D20F 


(53775) 


bit 2 enables fast pot scan 


PORTA 


$D300 


(53016) 


port A data 


PORTB 


$D301 


(53017) 


port B data 


PACTL 


$D302 


(54018) 


port A control 


PBCTL 


$D303 


(54019) 


port B control 


PENH 


$D40C 


(54284) 


light pen horizontal value 


PENV 


$D40D 


(54285) 


light pen vertical value 



Shadow registers 



LPENH $0234 

LPENV $0235 

PADDLO $0270 

I 

PADDL7 $0277 

STICKO $0278 



(564) 
(566) 
(624) 



light pen horizontal value 
light pen vertical value 
game paddle values 



(631) 

(532) : joystick registers 



STICKO $027B 
PRTIGO $027C 

i 
PTRIG7 $0283 
STRIGO $0284 



(635) : 

(636) : paddle triggers 

(643) : 

(644): joystick triggers 



STRIG3 $0287 



(647) : 



Go to chapter 17 
Go to chapter 19 
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CHAPTER 19 

Misc Hardware registers and information 



VERTICAL LINE COUNTER 

The ANTIC chip has a vertical line counter at $0D4B (54283). This counter shows the high 8 
bits of a 9 bit counter. This gives two line resolution. The value of this counter is placed into 
PENV [$D40D (54285)] when a joystick trigger is pressed. 



SERIAL PORT REGISTERS 

The POKEY chip has some registers which control the serial port. 

The serial port control register, SKCTL [$D20F (53775)], controls the serial port configuration 
and the game paddle scan mode, and some keyboard circuitry. 

The serial port control register 
76543210 
SKCTL I I I I I I I I I 



15318421 
2 4 2 6 



bits 

1 = enable keyboard debounce 

1 1 = enable keyboard scan 
both = set initialization mode. 

2 1 = fast pot scan 

3 1 = serial output is two tone (for cassette) 

instead of logical true/false 
4\ 

5 >- serial port mode control 
6/ 

7 1 = forced logical on output 

If the serial port control register is read from it gives the serial port status. The register is then 
called SKSTAT 



Serial port status register 
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76543210 
I I I I I I I HI 

15318421 
2 4 2 6 



bits 



not used, reads 1 

1 = serial input shift register busy 

2 = last key is still pressed 

3 = shift key pressed 

4 = direct from serial input port 

5 = keyboard over-run 

6 = serial data input over-run 

7 1 = serial data input frame error 



The serial port status is latched and must be reset by writing any number to its' reset 
register, SKRES [$D20A (53770)]. 



SERIAL PORT INPUT AND OUTPUT DATA 

When a full byte of serial input data has been received, it is read from the serial input data 
register, SERIN [$D20D (53773). Serial output data is written to the same register, which is 
then called the serial output data register, SEROUT. This register is usually written to in 
response to a serial output data interrupt (bit 4 of IRQST). 



HARDWARE CHIP MEMORY ALLOCATION 

The addresses for the hardware chips are not completely decoded. For example, the PIA 
needs only four bytes of memory but is active from $D300 - D3FF. Enough room for 64 PIA 
chips. A second pair of parallel ports could be added by accessing the address bus and 
further decoding the address for a second PIA. (This would also require a small modification 
of the computer's circuit board to disable the original PIA when the new one is active.) 
Similarly, there is room for 1 5 more POKEY or ANTIC chips and 7 gtia chips, should you 
ever need them. (GTIA uses $D000 - DOFF, POKEY uses $D200 - $D2FF and ANTIC uses 
$D400 - $D4FF.) 



Useful data base variables and OS equates 



SKRES $D20A (53770) 
SEROUT $D20D (53773) 
SERIN $D20D (53773) 



serial port status reset 
serial output data 
serial input data 
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SKCTL $D20F (53775) 
SKSTAT $D20F (53775) 
VCOUNT $D40B (54283) 



serial port control 
serial port status 
vertical line counter 



Os shadow registers 

SSKCTL $0232 (562) : SKCTL 



Go to chapter 18 
Go to chapter 20 



CHAPTER 20 



The XL and XE models 



BASIC B BUGS 

Most of the Atari 600XL and 800XL models were supplied with the "debugged" version B of 
Atari BASIC. This new BASIC got rid of the minor bugs of BASIC A and introduced some 
new major bugs of it's own. 

Each time a program is saved, 16 extra bytes are tagged onto the end of the program. After 
many saves and reloads, as when developing a long program, the program becomes too 
large for the memory. 

The computer may lock up unpredictably. 

Program line links may get messed up, leaving garbage in the listing and the program 
unrunable. 

Large LISTed programs may not run unless SAVed and reLOADed. 

If the length of a listed program is a multiple of a certain number of bytes, it will not run 
unless the length is somehow changed. 

BASIC version B has been replaced by version C. All of the XE models have this truly 
debugged version of BASIC. 
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NEW OPERATING SYSTEM PROBLEMS 

I have heard of only one bug in the operating system in XL and XE models. This is a 
mishandling of the printer timeout. The computer cannot tell if there is a printer attached or 
not. This may have been fixed in the XE models. However, many programs, some even 
formerly sold by Atari, do not jump through published jump vectors when using the operating 
system. These programs will not run on XL/XE models. (Some of these programs are Atari 
Word Processor (not Atariwriter) and LJKs Letter Perfect and Data Perfect.) Since the 
operating system ROM can be switched to RAM, a "translator" can be used to load the 800 
operating system into an XL or XE model. 



130XE MEMORY MANAGEMENT 

The 130XE has an extra 64K bank of memory. It is divided into four blocks of 16K each. 
Each block can be switched to replace part of the main bank of RAM from $4000 (1 6384) to 
$7FFF (32767). Furthermore, it can be switched in such a way that only the 6502, or the 
ANTIC chip can see the extra memory. 

Port B (formerly the two extra joystick ports of the 400/800) is used to manage the memory. 



Port B and memory management 
76543210 
PORTB |T|U|A|C|S S|B|R| 



16318421 
2 4 2 6 



R 1 = OS replaced by RAM 

B = BASIC enabled 

S S bank select bits 

C = CPU sees switched RAM at $4000 

A = ANTIC sees switched RAM 

U unused 

T = self test 



Bits 2 and 3 of PORTB select which block of the extra bank of memory is switched in. 



Bank 


se 


le 


!Ct bits 




bits 






block 




2 3 






address 











$0000 - 


$3FFF 


1 






$4000 - 


$7FFF 



100 



1 $8000 - $BFFF 
1 1 $C000 - $FFFF 



Bits 4 and 5 select which chip sees the switched in RAM at $4000 - $7FFF 



Chip select bits 



bits 


ANTIC 


6502 


4 5 









Ext. 


Ext. 


1 


Ext. 


Main 


1 


Main 


Ext. 


1 1 


Main 


Main 



THE XL PARALLEL PORT 



Pin out of the parallel port 

top from rear 

111112222233333444445 
2468024680246802468024680 



11111222223333344444 
1357913579135791357913579 



1 




2 


GND 




3 


Al 


4 


AO 




5 


A3 


6 


A2 




7 


A5 


8 


A4 




9 


GND 


10 


A6 




11 


A8 


12 


A7 




13 


AlO 


14 


A9 




15 


A12 


16 


All 




17 


A14 


18 


A13 




19 


A15 


20 


GND 




21 


Dl 


22 


DO 




23 


D3 


24 


D2 




25 


D5 


26 


D4 




27 


D7 


28 


D6 




29 


GND 


30 


GND 




31 


GND 


32 


phase 2 clock 


33 


RESET 


34 






35 


ROY 


36 


IRQ 




37 




37 






39 




40 






41 


GND 


42 







101 



3 


RAS 


44 




5 


R/W 


46 


GND 


7 


+ 5V 


48 


+ 5V 


9 


GND 


50 





The phase 2 clock runs at 1 .8 MHz. When the clock is high, the address and R/W lines are 
valid. The clock goes from high to low, when the data lines are also valid. All lines then 
become invalid. 

The 130XE doesn't have the parallel port. However, it has a cartridge slot expansion. This is 
a small cartridge-slot-like connector with the necessary connector to use parallel expansion. 



FINE SCROLLING 

If address $026E (622) is $FF, graphics will be in the fine scroll mode. 

OTHER ADDRESSES 

DSCTLN [$0D25,2 (725)] is the disk sector size, should be $80 (128). 

DMASAV [$02DD (735)] is a copy of the DMA control register, SDMCTL [$022F (559)]. It is 
set up when a channel is opened to the screen. The value is moved to SDMCTL whenever a 
key is pressed. It is used to restore the display if DMA is disabled. 

PUPBT [$033D,3 (829-831)] is used to test memory integrity when [RESET] is pressed. If 
these bytes are not $5C, $93 and $25, the computer will do a cold start when [RESET] is 
pressed. 

The self-test ROM is from $D000 to $D7FF, the same addresses as the hardware registers. 
This part of the operating system ROM is disabled when not used. When The computer is 
put into the self-test mode. This part of ROM is copied to $5000 to $57FF and run from 
there. 

GINTLK [$03FA (1018)] is a logical 1 if a cartridge is installed (built-in BASIC is considered a 
cartridge). BASIC can be disabled by poking 1018 with a non-zero number. If [RESET] is 
then pressed, the computer will attempt to load the DUP.SYS file and basic will be 
completely disabled. 



Go to chapter 19 
Go to appendix A 
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Appendix A 

Hardware Registers 



Register 



Name Description 



Shadow 
Address Name Address 



ALLPOT game paddle ready indicators $D208 53768 

AUDCl Audio channel 1 control $D201 53761 

AUDC2 Audio channel 2 control $D203 53763 

AUDC3 Audio channel 3 control $D205 53765 

AUDC4 Audio channel 1 control $D207 53767 

AUDCTL general audio control $D208 53768 

AUDFl Audio frequency 1 control $D200 53760 

AUDF2 Audio frequency 2 control $D202 53762 

AUDF3 Audio frequency 3 control $D204 53764 

AUDF4 Audio frequency 4 control $D206 53765 

CHACTL character control $D401 54273 

CHBASE Address of character set / 256 $D409 54281 

COLBK color/brightness of setcolor 4 $D01A 53274 

COLPFO Color/brightness of setcolor $D016 53270 

COLPFl color/brightness of setcolor 1 $D017 53271 

C0LPF2 color/brightness of setcolor 2 $D018 53272 

C0LPF3 color/brightness of setcolor 3 $D019 53273 

COLPMO color/brightness, player/missile $D012 53266 

COLPMl color/brightness, player/missile 1 $D013 53267 

C0LPM2 color/brightness, player/missile 2 $D014 53268 

C0LPM3 color/brightness, player/missile 3 $D015 53269 

CONSOL [START], [SELECT], [OPT.], speaker $D01F 53279 



CHART 

CHBAS 

C0L0R4 

COLORO 

COLORl 

C0L0R2 

C0L0R3 

PCOLRO 

PCOLRl 

PC0LR2 

PC0LR3 



$02F3 755 

$02F4 756 

$02C8 712 

$02C4 708 

$02C5 709 

$02C6 710 

$02C7 711 

$02C0 704 

$02C1 705 

$02C2 706 

$02C3 707 



103 



DLISTH display list pointer high byte $D403 54275 SDLSTH $0231 561 

DLISTL display list pointer low byte $D402 54274 SDLSTL $0230 560 

DMACTL Direct Memory access control (DMA) $D400 54272 SDMCTL $022F 559 

GRACTL graphics control $D01D 53277 

GRAFM missile graphics $D011 53265 

GRAFPO player graphics $DOOD 53261 

GRAFPl player 1 graphics $DOOE 53262 

GRAFP2 player 2 graphics $DOOF 53263 

GRAFP3 player 3 graphics $D010 53264 

HITCLR clear collisions $D01E 54278 

HPOSMO horizontal position of missile $D004 53252 

HPOSMl horizontal position of missile 1 $D005 53253 

HP0SM2 horizontal position of missile 2 $D006 53254 

H0PSM3 horizontal position of missile 3 $D007 53255 

HPOSPO horizontal position of player $D000 53248 

HPOSPl horizontal position of player 1 $D001 53249 

HP0SP2 horizontal position of player 2 $D002 53250 

HP0SP3 horizontal position of player 3 $D003 53251 

HSCROL horizontal scroll $D404 54275 

IRQEN interrupt request enable (IRQ) $D20E 53774 POKMSK $0010 16 

IRQST IRQ status $D20E 53774 

KBCODE keyboard code $D209 53769 CH $02FC 764 

MOPF missile to graphics collisions $D000 53248 

MOPL missile to player collisions $D008 53256 

MIPF missile 1 to graphics collisions $D001 53249 

MIPL missile 1 to player collisions $D009 53257 

M2PF missile 2 to graphics collisions $D002 53250 

M2PL missile 2 to player collisions $DOOA 53258 

M3PF missile 3 to graphics collisions $D003 53251 

M3PL missile 3 to player collisions $DOOB 53259 
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NMIEN non-maskable interrupt enable (NMI) 

NMIRES NMI reset 

NMIST NMI status 

POPF player to graphics collisions 

POPL player to player collisions 

PIPF player 1 to graphics collisions 

PIPL player 1 to player collisions 

P2PF player 2 to graphics collisions 

P2PL player 2 to player collisions 

P3PF player 3 to graphics collisions 

P3PL player 3 to player collisions 

PACTL port A control 

PAL Europe/North America TV indicator 

PBCLT port B control 

PENH light pen horizontal position 

PENV light pen vertical position 

PMBASE player/missile address / 256 

PORTA port A 

PORTB port B 

POTO game paddle 

POTl game paddle 1 

P0T2 game paddle 2 

P0T3 game paddle 3 

P0T4 game paddle 4 

POTS game paddle 5 

P0T6 game paddle 6 

P0T7 game paddle 7 

POTGO start pot scan sequence 



$D40E 


54286 








$D40F 


54287 








$D40F 


54287 








$D004 


53252 








$DOOC 


53260 








$D005 


53253 








$DOOD 


53261 








$D006 


53254 








$DOOE 


53262 








$D007 


53255 








$DOOF 


53263 








$D302 


54018 








$D014 


53268 








$D303 


54019 








$D40C 


54284 


LPENH 


$0234 


564 


$D40D 


54285 


LPENV 


$0235 


565 


$D407 


54279 








$D300 


54016 


STICKO 


$0278 


632 






STICKl 


$0279 


634 


$D301 


54017 


STICK2 


$027A 


634 






STICK3 


$027B 


635 


$D200 


53760 


PADDLO 


$0270 


624 


$D201 


53761 


PADDLl 


$0271 


625 


$D202 


53762 


PADDL2 


$0272 


626 


$D203 


53763 


PADDL3 


$0273 


627 


$D204 


53764 


PADDL4 


$0274 


628 


$D205 


53765 


PADDL5 


$0275 


629 


$D206 


53766 


PADDL6 


$0276 


630 


$D207 


53767 


PADDL7 


$0277 


631 


$D20B 


53771 
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PRIOR p/m priority and GTIA mode 

RANDOM random number generator 

SERIN serial port input 

SEROUT serial port output 

SIZEM missile size 

SIZEPO player size 

SIZEPl player 1 size 

SIZEP2 player 2 size 

SIZEP3 player 3 size 

SKCTL serial port control 

SKREST reset serial port status 

SKSTAT serial port status 

STIMER start timer 

TRIGO joystick trigger 

TRIGl joystick trigger 1 

TRIG2 joystick trigger 2 

TRIGS joystick trigger 3 

VCOUNT vertical line counter 

VDELAY vertical delay 

VSCROL vertical scroll 

WSYNC wait for horizontal sync 



$D21B 53275 GPRIOR $026F 623 

$D20A 53770 

$D20D 53774 

$D20D 53773 

$DOOC 53260 

$D008 53256 

$D009 53257 

$DOOA 53258 

$DOOB 53259 

$D20F 53775 SSKCTL $0232 563 

$D20A 53770 

$D20F 53775 

$D209 53769 

$D010 53264 STRIGO $0284 644 

$D011 53265 STRIGl $0285 645 

$D012 53266 STRIG2 $0286 646 

$D013 53267 STRIG3 $0287 647 

$D40B 54283 

$D01C 54275 

$D405 54277 

$D40A 54282 



NUMERICAL ORDER 



Registers sharing addresses are listed first when writen to, then when read from 



Register 



Shadow 



Name Description 



Address Name Address 
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HPOSPO horizontal position of player $D000 53248 

MOPF missile to graphics collisions $D000 53248 

HPOSPl horizontal position of player 1 $D001 53249 

MIPF missile 1 to graphics collisions $D001 53249 

HP0SP2 horizontal position of player 2 $D002 53250 

M2PF missile 2 to graphics collisions $D002 53250 

HP0SP3 horizontal position of player 3 $D003 53251 

M3PF missile 3 to graphics collisions $D003 53251 

HPOSMO horizontal position of missile $D004 53252 

POPF player to graphics collisions $D004 53252 

HPOSMl horizontal position of missile 1 $D005 53253 

PIPF player 1 to graphics collisions $D005 53253 

HP0SM2 horizontal position of missile 2 $D006 53254 

P2PF player 2 to graphics collisions $D006 53254 

H0PSM3 horizontal position of missile 3 $D007 53255 

P3PF player 3 to graphics collisions $D007 53255 

SIZEPO player size $D008 53256 

MOPL missile to player collisions $D008 53256 

SIZEPl player 1 size $D009 53257 

MIPL missile 1 to player collisions $D009 53257 

SIZEP2 player 2 size $DOOA 53258 

M2PL missile 2 to player collisions $DOOA 53258 

SIZEP3 player 3 size $DOOB 53259 

M3PL missile 3 to player collisions $DOOB 53259 

SIZEM missile size $DOOC 53260 

POPL player to player collisions $DOOC 53260 

GRAFPO player graphics $DOOD 53261 

PIPL player 1 to player collisions $DOOD 53261 

GRAFPl player 1 graphics $DOOE 53262 

P2PL player 2 to player collisions $DOOE 53262 
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GRAFP2 player 2 graphics $DOOF 53263 

P3PL player 3 to player collisions $DOOF 53263 

GRAFP3 player 3 graphics $D010 53264 

TRIGO joystick trigger $D010 53264 

GRAFM missile graphics $D011 53265 

TRIGl joystick trigger 1 $D011 53265 

COLPMO color/brightness, player/missile $D012 53266 

TRIG2 joystick trigger 2 $D012 53266 

COLPMl color/brightness, player/missile 1 $D013 53267 

TRIG3 joystick trigger 3 $D013 53267 

C0LPM2 color/brightness, player/missile 2 $D014 53268 

PAL Europe/North America TV indicator $D014 53268 

C0LPM3 color/brightness, player/missile 3 $D015 53269 

COLPFO Color/brightness of setcolor $D016 53270 

COLPFl color/brightness of setcolor 1 $D017 53271 

C0LPF2 color/brightness of setcolor 2 $D018 53272 

C0LPF3 color/brightness of setcolor 3 $D019 53273 

COLBK color/brightness of setcolor 4 $D01A 53274 

VDELAY vertical delay $D01C 54275 

GRACTL graphics control $D01D 53277 

HITCLR clear collisions $D01E 54278 

CONSOL [START], [SELECT], [OPT.], speaker $D01F 53279 

AUDFl Audio frequency 1 control $D200 53760 

POTO game paddle $D200 53760 

AUDCl Audio channel 1 control $D201 53761 

POTl game paddle 1 $D201 53761 

AUDF2 Audio frequency 2 control $D202 53762 

P0T2 game paddle 2 $D202 53762 

AUDC2 Audio channel 2 control $D203 53763 

P0T3 game paddle 3 $D203 53763 



STRIGO $0284 644 



STRIGl 
PCOLRO 
STRIG2 
PCOLRl 
STRIG3 
PC0LR2 

PC0LR3 
COLORO 
COLORl 
C0L0R2 
C0L0R3 
C0L0R4 



$0285 645 

$02C0 704 

$0286 646 

$02C1 705 

$0287 647 

$02C2 706 

$02C3 707 

$02C4 708 

$02C5 709 

$02C6 710 

$02C7 711 

$02C8 712 



PADDLO $0270 624 



PADDLl $0271 625 



PADDL2 $0272 626 



PADDL3 $0273 627 
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AUDF3 Audio frequency 3 control 

P0T4 game paddle 4 

AUDC3 Audio channel 3 control 

POTS game paddle 5 

AUDF4 Audio frequency 4 control 

POTS game paddle 6 

AUDC4 Audio channel 1 control 

P0T7 game paddle 7 

ALLPOT game paddle ready indicators 

AUDCTL general audio control 

KBCODE keyboard code 

STIMER start timer 

RANDOM random number generator 

SKREST reset serial port status 

POTGO start pot scan sequence 

SEROUT serial port output 

SERIN serial port input 

IRQEN interrupt request enable (IRQ) 

IRQST IRQ status 

SKCTL serial port control 

SKSTAT serial port status 

PRIOR p/m priority and GTIA mode 

PORTA port A 

PORTB port B 

PACTL port A control 

PBCTL port B control 

DMACTL Direct Memory access control (DMA) 

CHACTL character control 



$D204 


53764 








$D204 


53764 


PADDL4 


$0274 


628 


$D205 


53765 








$D205 


53765 


PADDL5 


$0275 


629 


$D206 


53766 








$D206 


53766 


PADDL6 


$0276 


630 


$D207 


53767 








$D207 


53767 


PADDL7 


$0277 


631 


$D208 


53768 








$D208 


53768 








$D209 


53769 


CH 


$02FC 


764 


$D209 


53769 








$D20A 


53770 








$D20A 


53770 








$D20B 


53771 








$D20D 


53773 








$D20D 


53774 








$D20E 


53774 


POKMSK 


$0010 


16 


$D20E 


53774 








$D20F 


53775 


SSKCTL 


$0232 


563 


$D20F 


53775 








$D21B 


53275 


GPRIOR 


$026F 


623 


$D300 


54016 


STICKO 


$0278 


632 






STICKl 


$0279 


633 


$D301 


54017 


STICK2 


$027A 


634 






STICK3 


$027B 


635 


$D302 


54018 








$D303 


54019 








$D400 


54272 


SDMCTL 


$022F 


559 


$D401 


54273 


CHART 


$02F3 


755 
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DLISTL display list pointer low byte 

DLISTH display list pointer high byte 

HSCROL horizontal scroll 

VSCROL vertical scroll 

PMBASE player/missile address / 256 

CHBASE Address of character set / 256 

WSYNC wait for horizontal sync 

VCOUNT vertical line counter 

PENH light pen horizontal position 

PENV light pen vertical position 

NMIEN non-maskable interrupt enable (NMI) $D40E 54286 

NMIRES NMI reset $D40F 54287 

NMIST NMI status $D40F 54287 



$D402 54274 SDLSTL $0230 560 

$D403 54275 SDLSTH $0231 561 

$D404 54276 

$D405 54277 

$D407 54279 

$D409 54281 CHBAS $02F4 756 

$D40A 54282 

$D40B 54283 

$D40C 54284 LPENH $0234 564 

$D40D 54285 LPENV $0235 565 



SHADOW REGISTER ORDER 



ALPHEBETICAL ORDER 



Register 



Shadow 



Name Description 



Address Name 



Address 



KBCODE keyboard code 

CHACTL character control 

CHBASE Address of character set / 256 

COLBK color/brightness of setcolor 4 

COLPFO Color/brightness of setcolor 

COLPFl color/brightness of setcolor 1 

C0LPF2 color/brightness of setcolor 2 



$D209 53769 CH $02FC 764 

$D401 54273 CHART $02F3 755 

$D409 54281 CHBAS $02F4 756 

$D01A 53274 C0L0R4 $02C8 712 

$D016 53270 COLORO $02C4 708 

$D017 53271 COLORl $02C5 709 

$D018 53272 C0L0R2 $02C6 710 
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C0LPF3 color/brightness of setcolor 3 

PRIOR p/m priority and GTIA mode 

PENH light pen horizontal position 

PENV light pen vertical position 

POTO game paddle 

POTl game paddle 1 

P0T2 game paddle 2 

POTS game paddle 3 

P0T4 game paddle 4 

POTS game paddle 5 

P0T6 game paddle 6 

P0T7 game paddle 7 

COLPMO color/brightness, player/missile 

COLPMl color/brightness, player/missile 1 

C0LPM2 color/brightness, player/missile 2 

C0LPM3 color/brightness, player/missile 3 

IRQEN interrupt request enable (IRQ) 

DLISTH display list pointer high byte 

DLISTL display list pointer low byte 

DMACTL Direct Memory access control (DMA) 

SKCTL serial port control 

PORTA port A 

PORTB port B 

TRIGO joystick trigger 

TRIGl joystick trigger 1 

TRIG2 joystick trigger 2 

TRIG3 joystick trigger 3 



$D019 


53273 


C0L0R3 


$02C7 


711 


$D21B 


53275 


GPRIOR 


$026F 


623 


$D40C 


54284 


LPENH 


$0234 


564 


$D40D 


54285 


LPENV 


$0235 


565 


$D200 


53760 


PADDLO 


$0270 


624 


$D201 


53761 


PADDLl 


$0271 


625 


$D202 


53762 


PADDL2 


$0272 


626 


$D203 


53763 


PADDL3 


$0273 


627 


$D204 


53764 


PADDL4 


$0274 


628 


$D205 


53765 


PADDL5 


$0275 


629 


$D206 


53766 


PADDL6 


$0276 


630 


$D207 


53767 


PADDL7 


$0277 


631 


$D012 


53266 


PCOLRO 


$02C0 


704 


$D013 


53267 


PCOLRl 


$02C1 


705 


$D014 


53268 


PC0LR2 


$02C2 


706 


$D015 


53269 


PC0LR3 


$02C3 


707 


$D20E 


53774 


POKMSK 


$0010 


16 


$D403 


54275 


SDLSTH 


$0231 


551 


$D402 


54274 


SDLSTL 


$0230 


560 


$D400 


54272 


SDMCTL 


$022F 


559 


$D20F 


53775 


SSKCTL 


$0232 


563 


$D300 


54016 


STICKO 


$0278 


632 






STICKl 


$0279 


633 


$D301 


54017 


STICK2 


$027A 


634 






STICK3 


$027B 


635 


$D010 


53264 


STRIGO 


$0284 


644 


$D011 


53265 


STRIGl 


$0285 


645 


$D012 


53266 


STRIG2 


$0286 


646 


$D013 


53267 


STRIG3 


$0287 


647 
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NUMERICAL ORDER 



IRQEN interrupt request enable (IRQ) 

DMACTL Direct Memory access control (DMA) 

DLISTL display list pointer low byte 

DLISTH display list pointer high byte 

SKCTL serial port control 

PENH light pen horizontal position 

PENV light pen vertical position 

PRIOR p/m priority and GTIA mode 

POTO game paddle 

POTl game paddle 1 

P0T2 game paddle 2 

POTS game paddle 3 

P0T4 game paddle 4 

POTS game paddle 5 

P0T6 game paddle 6 

P0T7 game paddle 7 

PORTA port A 

PORTB port B 

TRIGO joystick trigger 

TRIGl joystick trigger 1 

TRIG2 joystick trigger 2 

TRIG3 joystick trigger 3 

COLPMO color/brightness, player/missile 

COLPMl color/brightness, player/missile 1 

C0LPM2 color/brightness, player/missile 2 



$D20E 


53774 


POKMSK 


$0010 


16 


$D400 


54272 


SDMCTL 


$022F 


559 


$D402 


54274 


SDLSTL 


$0230 


560 


$D403 


54275 


SDLSTH 


$0231 


561 


$D20F 


53775 


SSKCTL 


$0232 


563 


$D40C 


54284 


LPENH 


$0234 


564 


$D40D 


54285 


LPENV 


$0235 


565 


$D21B 


53275 


GPRIOR 


$026F 


623 


$D200 


53760 


PADDLO 


$0270 


624 


$D201 


53761 


PADDLl 


$0271 


625 


$D202 


53762 


PADDL2 


$0272 


626 


$D203 


53763 


PADDL3 


$0273 


627 


$D204 


53764 


PADDL4 


$0274 


628 


$D205 


53765 


PADDL5 


$0275 


629 


$D206 


53766 


PADDL6 


$0276 


630 


$D207 


53767 


PADDL7 


$0277 


631 


$D300 


54016 


STICKO 


$0278 


632 






STICKl 


$0279 


633 


$D301 


54017 


STICK2 


$027A 


634 






STICK3 


$027B 


635 


$D010 


53264 


STRIGO 


$0284 


644 


$D011 


53265 


STRIGl 


$0285 


645 


$D012 


53266 


STRIG2 


$0286 


646 


$D013 


53267 


STRIG3 


$0287 


647 


$D012 


53266 


PCOLRO 


$02C0 


704 


$D0I3 


53267 


PCOLRl 


$02C1 


705 


$D014 


53268 


PC0LR2 


$02C2 


706 
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C0LPM3 color/brightness, player/missile 3 $D015 53269 PC0LR3 $02C3 707 



COLPFO Color/brightness of setcolor 
COLPFl color/brightness of setcolor 1 
C0LPF2 color/brightness of setcolor 2 
C0LPF3 color/brightness of setcolor 3 
COLBK color/brightness of setcolor 4 
CHACTL character control 
CHBASE Address of character set / 256 
KBCODE keyboard code 



$D016 53270 COLORO $02C4 708 

$D017 53271 COLORl $02C5 709 

$D018 53272 C0L0R2 $02C6 710 

$D019 53273 C0L0R3 $02C7 711 

$D01A 53274 C0L0R4 $02C8 712 

$D401 54273 CHART $02F3 755 

$D409 54281 CHBAS $02F4 756 

$D209 53769 CH $02FC 754 



Go to Chapter 20 
Go to appendix B 



APPENDIX B 



Operating System Equates 



0100 
0101 
0102 
0103 
0104 
0105 
0106 
0107 
0108 
0109 
0110 
0111 
0112 
0113 
0114 
0115 
0116 
0117 
0118 
0119 
0120 
0121 
0122 



ATARI 800 EQUATE LISTING 



This listing is based on the original release of Operating System, 
version A. The vectors shown here were not changed in version B. 
New equates for XL and XE models are included and noted. Changes 
from version B to XL/XE are also noted. 

Most of the equate names given below are the official Atari 
names. They are in common use but are not mandatory. 



DEVICE NAMES 



SCREDT = "E" 

KBD = "K" 

DISPLY = "S" 

PRINTR = "P" 

CAS SET = "C" 

DISK = "D" 



SCREEN EDITOR 

KEYBOARD 

DISPLAY 

PRINTER 

CASSETTE 

DISK DRIVE 
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0123 
0124 
0125 
0126 
0127 
0128 
0129 
0130 
0131 
0132 
0133 
0134 
0135 
0136 
0137 
0138 
0139 
0140 
0141 
0142 
0143 
0144 
0145 
0146 
0147 
0148 
0149 
0150 
0151 
0152 
0153 
0154 
0155 
0156 
0157 
0158 
0159 
0160 
0161 
0162 
0163 
0164 
0165 
0166 
0167 
0168 
0169 
0170 
0171 
0172 
0173 
0174 
0175 
0176 
0177 
0178 
0179 
0180 
0181 
0182 



STATUS CODES 



SUCCES 

BRKABT 

PRVOPN 

NONDEV 

WRONLY 

NVALID 

NOTOPN 

BAD IOC 

RDONLY 

EOFERR 

TRNRCD 

TIMOUT 

DNACK 

FRMERR 

CRSROR 

OVRRUN 

CHKERR 

DERROR 

BADMOD 

FNCNOT 

SCRMEM 



$01 
$80 
$82 
$82 
$83 
$84 
$85 
$86 
$87 
$88 
$89 
$8A 
$88 
$80 
$8D 
$8E 
$8F 
$90 
$91 
$92 
$93 



1 
128 
130 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 



BREAK KEY ABORT 

lOCB ALREADY OPEN 

NONEXISTANT DEVICE 

OPENED FOR WRITE ONLY 

INVALID COMMAND 

DEVICE OR FILE NOT OPEN 

INVALID lOCB NUMBER 

OPENED FOR READ ONLY 

END OF FILE 

TRUNCATED RECORD 

PERIPHERAL TIME OUT 

DEVICE DOES NOT ACKNOWLEDGE 

SERIAL BUS FRAMING ERROR 

CURSOR OUT OF RANGE 

SERIAL BUS DATA OVERRUN 

SERIAL BUS CHECKSUM ERROR 

PERIPHERAL DEVICE ERROR 

NON EXISTANT SCREEN MODE 

FUNCTION NOT IMPLEMENTED 

NOT ENOUGH MEMORY FOR SCREEN MODE 



COMMAND CODES FOR CIO 



OPEN 

OPREAD 

GETREC 

OPDIR 

GETCHR 

OWRITE 

PUTREC 

APPEND 

MXDMOD 

PUTCHR 

CLOSE 

OUPDAT 

STATUS 

SPECIL 

DRAWLN 

FILLIN 

RENAME 

INSCLR 

DELETE 

DFRMAT 

LOCK 

UNLOCK 

POINT 

NOTE 

PTSECT 

GTSECT 



$03 
$04 
$05 
$06 
$07 
$08 
$09 
$09 
$10 
$0B 
$0C 
$0C 
$0D 
$0E 
$11 
$12 
$20 
$20 
$21 
$21 
$23 
$24 
$25 
$26 
$50 
$52 



9 

16 
11 
12 
12 
13 
14 
17 
18 
32 
32 
33 
33 
35 
36 
37 
38 
80 
82 



OPEN FOR INPUT 

GET RECORD 

OPEN TO DISK DIRECTORY 

GET BYTE 

OPEN FOR OUTPUT 

WRITE RECORD 

OPEN TO APPEND TO END OF DISK FILE 

OPEN TO SPLIT SCREEN (MIXED MODE) 

PUT-BYTE 

OPEN FOR INPUT AND OUTPUT AT THE SAME TIME 

BEGINNING OF SPECIAL COMMANDS 
SCREEN DRAW 
SCREEN FILL 

OPEN TO SCREEN BUT DON'T ERASE 

FORMAT DISK (RESIDENT DISK HANDLER (RDH) ) 



RDH PUT SECTOR 
RDH GET SECTOR 
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0183 
0184 
0185 
0186 
0187 
0188 
0189 
0190 
0191 
0192 
0193 
0194 
0195 
0196 
0197 
0198 
0199 
0200 
0201 
0202 
0203 
0204 
0205 
0206 
0207 
0208 
0209 
0210 
0211 
0212 
0213 
0214 
0215 
0216 
0217 
0218 
0219 
0220 
0221 
0222 
0223 
0224 
0225 
0226 
0227 
0228 
0229 
0230 
0231 
0232 
0233 
0234 
0235 
0236 
0237 
0238 
0239 
0240 
0241 
0242 



DSTAT 
PSECTV 
NOIRG 
CR 

lOCBSZ 
MAX IOC 
lOCBF 

LEDGE 
REDGE 



= $53 83 RDH GET STATUS 

= $57 87 RDH PUT SECTOR AND VERIFY 

= $80 128 NO GAP CASSETTE MODE 

= $9B 155 CARRIAGE RETURN (EOL) 

= $10 16 lOCB SIZE 

= $80 128 MAX lOCB BLOCK SIZE 

= $FF 255 lOCB FREE 

= $02 2 DEFAULT LEFT MARGIN 

= $27 39 DEFAULT RIGHT MARGIN 

OS VARIABLES 



PAGE 



LINZBS 

NGFLAG 

CASINI 

RAMLO 

TRAMS Z 

TSTDAT 

WARMS T 

BOOT? 

DOSVEC 

DOSINI 

APPMHI 

POKMSK 

BRKKEY 

RTCLOK 

BUFADR 

ICCOMT 

DSKFMS 

DSKUTL 

PTIMOT 

ABUFPT 

PBPNT 

PBUFSZ 

PTEMP 

ZIOCB 

ICHIDZ 

ICDNOZ 

ICCOMZ 

ICSTAZ 

ICBALZ 

ICBAHZ 

ICPTLZ 

ICPTHZ 

ICBLLZ 

ICBLHZ 

ICAXIZ 

ICAX2Z 

ICSPRZ 

ICIDNO 

CIOCHR 



$00 
$00 
$01 
$02 
$04 
$06 
$07 
$08 
$09 
$0A 
$0C 
$0E 
$10 
$11 
$12 
$15 
$17 
$18 
$1A 
$1C 
$1C 
$1D 
$1D 
$1E 
$1E 
$1F 
$1F 
$20 
$20 
$21 
$22 
$23 
$24 
$25 
$26 
$27 
$28 
$29 
$2A 
$2B 
$20 
$2E 
$2F 



(800) FOR ORIGINAL DEBUGGER 

(XL) RESERVED 

(XL) FOR POWER-UP SELF TEST 

POINTER FOR SELF TEST 
TEMPORARY RAM SIZE 





1 
2 
4 
6 
7 TEST DATA 



9 SUCCESSFUL BOOT FLAG 
10 PROGRAM RUN VECTOR 
12 PROGRAM INITIALIZATION 
14 DISPLAY LOW LIMIT 

16 IRQ ENABLE FLAGS 

17 FLAG 

18 3 BYTES, MSB FIRST 

21 INDIRECT BUFFER ADDRESS 

2 3 COMMAND FOR VECTOR 

24 DISK FILE MANAGER POINTER 

26 DISK UTILITY POINTER (DUP.SYS) 

28 (800) PRINTER TIME OUT REGISTER 

28 (XL) RESERVED 

29 (800) PRINTER BUFFER POINTER 

2 9 (XL) RESERVED 

30 (800) PRINTER BUFFER SIZE 

30 (XL) RESERVED 

31 (800) TEMPORARY REGISTER 

31 (XL) RESERVED 

32 ZERO PAGE lOCB 

32 HANDLER INDEX NUMBER (ID) 

33 DEVICE NUMBER 

34 COMMAND 

35 STATUS 

3 6 BUFFER POINTER LOW BYTE 

37 BUFFER POINTER HIGH BYTE 

38 PUT ROUTINE POINTER LOW 

39 PUT ROUTINE POINTER HIGH 

4 BUFFER LENGTH LOW 
41 

42 AUXILIARY INFORMATION BYTE 1 

43 

44 TWO SPARE BYTES (CIO USE) 

4 6 lOCB NUMBER X 16 

47 CHARACTER BYTE FOR CURRENT OPERATION 
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0243 


STATUS = 


$30 


0244 


CHKSUM = 


$31 


0245 


BUFRLO = 


$32 


0246 


BUFRHI = 


$33 


0247 


BFENLO = 


$34 


0248 


BFENHI = 


$35 


0249 


CRETRY = 


$36 


0250 


LTEMP = 


$36 


0251 


DRETRY = 


$37 


0252 


BUFRFL = 


$38 


0253 


RECVDN = 


$39 


0254 


XMTDON = 


$3A 


0255 


CHKSNT = 


$3B 


0256 


NOCKSM = 


$3C 


0257 


BPTR 


$3D 


0258 


FTYPE = 


$3E 


0259 


FEOF 


$3F 


0250 


FREQ 


$40 


0261 


; 




0262 


SOUNDR = 


$41 


0263 


CRITIC = 


$42 


0264 


FMSZPG = 


$43 


0265 


CKEY 


$4A 


0266 


ZCHAIN = 


$4A 


0267 


CASSBT = 


$4B 


0268 


DSTAT = 


$4C 


0269 


f 




0270 


ATRAC T = 


$4D 


0271 


DRKMSK = 


$4E 


0272 


COLRSH = 


$4F 


GRAPHICS) 




0273 


/ 




0274 


TMPCHR = 


$50 


0275 


HOLDl = 


$51 


0276 


LMARGN = 


$52 


0277 


RMARGN = 


$53 


0278 


ROWCRS = 


$54 


0279 


COLCRS = 


$55 


0280 


DINDEX = 


$57 


0281 


SAVMSC = 


$58 


0282 


OLDROW = 


$5A 


0283 


OLDCOL = 


$5B 


0284 


OLDCHR = 


$5D 


0285 


OLDADR = 


$5E 


0286 


NEWROW = 


$60 


0287 


FKDEF = 


$60 


0288 


NEWCOL = 


$61 


0289 


PALNTS = 


$62 


0290 


LOGCOL = 


$63 


0291 


ML T IMP = 


$66 


0292 


OPNTMP = 


$66 


0293 


SAVADR = 


$68 


0294 


RAMTOP = 


$6A 


ONLY 






0295 


BUFCNT = 


$6B 


0296 


BUFSTR = 


$6C 


0297 


BITMSK = 


$6E 


0298 


SHE AMI = 


$6F 


0299 


ROWAC = 


$70 


0300 


COLAC = 


$72 



90 

91 

93 

94 

96 

96 

97 

98 

99 

102 

102 

104 

106 



STATUS STORAGE 

SUM WITH CARRY ADDED BACK 

DATA BUFFER LOW BYTE 

ADDRESS OF LAST BUFFER BYTE +1 (LOW) 

(800) NUMBER OF COMMAND FRAME RETRIES 
(XL) LOADER TEMPORARY STORAGE, 2 BYTES 
(800) DEVICE RETRIES 

BUFFER FULL FLAG 

RECEIVE DONE FLAG 

TRANSMISSION DONE FLAG 

CHECKSUM-SENT FLAG 

CHECKSUM-DOES-NOT-FOLLOW-DATA FLAG 



48 
49 
50 
51 
52 
53 
54 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 



65 0=QUIET I/O 

6 6 CRITICAL FUNCTION FLAG, NO DEFFERED VBI 
67 DOS ZERO PAGE, 7 BYTES 

7 4 (800) START KEY FLAG 

74 (XL) HANDLER LOADER TEMP, 2 BYTES 

75 (800) CASSETTE BOOT FLAG 
7 6 DISPLAY STATUS 

77 

7 8 ATTRACT MASK 

7 9 ATTRACT COLOR SHIFTER (EORed WITH 



80 
81 
82 
83 
84 
85 
87 



SCREEN LEFT MARGIN REGISTER 

SCREEN RIGHT MARGIN 

CURSOR ROW 

CURSOR COLUMN, 2 BYTES 

DISPLAY MODE 

SCREEN ADDRESS 

CURSOR BEFORE DRAW OR FILL 

DATA UNDER CURSOR 

CURSOR ADDRESS 
(800) DRAWTO DESTINATION 
(XL) FUNCTION KEY DEFINATION POINTER 
(800) DRAWTO DESTINATION, 2 BYTES 
(XL) EUROPE/NORTH AMERICA TV FLAG 

LOGICAL LINE COLUMN POINTER 

TEMPORARY STORAGE FOR CHANNEL OPEN 
START OF ROM (END OF RAM +1), HIGH BYTE 



107 BUFFER COUNT 

108 POINTER USED BY EDITOR 
110 POINTER USED BY EDITOR 
111 

112 
114 
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0301 
0302 

0303 
0304 
0305 
0306 
0307 
0308 
0309 
0310 
0311 
0312 
0313 
0314 
0315 
0316 
0317 
0318 
0319 
0320 
0321 
0322 
0323 
0324 
0325 
0326 
0327 
0328 
0329 
0330 
0331 
0332 
0333 
0334 
0335 
0336 
0337 
0338 
0339 
0340 
0341 
0342 
0343 
0344 
0345 
0346 
0347 
0348 
0349 
0350 
0351 
0352 
0353 
0354 
0355 
0356 
0357 
0358 
0359 
0360 



ENDPT 

DELTAR 

DELTAC 

ROWING 

KEYDEF 

COLINC 

SWPFLG 

HOLDCH 

INSDAT 

COUNTR 

ZROFRE 

FPZRO 

FRO 

FRE 

FRl 

FR2 

FRX 

EEXP 

NSIGN 

ESIGN 

FCHFLG 

DIGRT 

CIX 

INBUFF 

Z TEMPI 

Z TEMP 4 

Z TEMP 3 

DEGFLG 

RADFLG 

FLPTR 

FPTR2 



$74 
$76 
$77 
$79 
$79 
$7A 
$7B 
$7C 
$7D 
$7E 

$80 
$D4 
$D4 
$DA 
$E0 
$E6 
$EC 
$ED 
$ED 
$EF 
$F0 
$F1 
$F2 
$F3 
$F5 
$F7 
$F9 
$FB 
$FB 
$FC 
$FE 



INTABS 
VDSLST 
VPRCED 
VINTER 
VBREAK 
VKEYBD 
VSERIN 
VSEROR 
VSEROC 
VTIMRl 
VTIMR2 
VTIMR4 
VIMIRQ 
CDTMVl 
CDTMV2 
CDTMV3 



116 
118 
119 
121 (800) 

121 (XL) KEY DEFINATION POINTER, 2 BYTES 

122 (800) 

123 NON IF TEXT AND REGULAR RAM IS SWAPPED 

124 CH MOVED HERE BEFORE CTRL AND SHIFT 
125 

126 

128 
212 
212 
218 
224 
230 
236 
237 
237 
239 
240 
241 
242 
243 
245 
247 
249 
251 
251 
252 
254 



PAGE 1 
6502 STACK 

PAGE 2 



$0200 
$0200 
$0202 
$0204 
$0205 
$0208 
$020A 
$020C 
$020E 
$0210 
$0212 
$0214 
$0215 
$0218 
$021A 
$021C 



FREE ZERO PAGE, 84 BYTES 
FLOATING POINT RAM, 4 3 BYTES 
FP REGISTER 

FP REGISTER 1 

FP REGISTER 2 

SPARE 

VALUE OF E 

SIGN OF FP NUMBER 

SIGN OF FP EXPONENT 

FIRST CHARACTER FLAG 

NUMBER OF DIGITS RIGHT OF DECIMAL POINT 

INPUT INDEX 

POINTER TO ASCII FP NUMBER 



0=RADIANS, 5=DEGREES 
POINTER TO BCD FP NUMBER 



512 
512 
514 
516 
518 
520 
522 
524 
526 
528 
530 
532 
534 
536 
538 
540 



INTERRUPT RAM 

NMI VECTOR 

PROCEED LINE IRQ VECTOR 

INTERRUPT LINE IRQ VECTOR 



SERIAL INPUT READY IRQ 

SERIAL OUTPUT READY IRQ 

SERIAL OUTPUT COMPLETE IRQ 

TIMER 1 IRQ 

TIMER 2 IRQ 

TIMER 4 IRQ 

IRQ VECTOR 

DOWN TIMER 1 

DOWN TIMER 2 

DOWN TIMER 3 
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03 61 CDTMV4 

0362 CDTMV5 

0363 WBLKI 
03 64 WBLKD 
0365 CDTMAl 

03 6 6 CDTMA2 

0367 CDTMF3 

0368 SRTIMR 

0369 CDTMF4 
037 INTEMP 

0371 CDTMF5 

0372 SDMCTL 

0373 SDLSTL 

0374 SSKCTL 

0375 ; 

037 6 LCOUNT 
0377 LPENH 

037 8 LPENV 

0379 ; 

0380 ; 

0381 RELADR 

0382 CDEVIC 

0383 CAUXl 

0384 CAUX2 

0385 TEMP 

038 6 ERRFLG 

0387 DFLAGS 

0388 DBSECT 
038 9 BOOTAD 

0390 COLDST 
PROGRESS 

0391 ; 

0392 RECLEN 

0393 DSKTIM 

0394 ; 

0395 LINBUF 

0396 CHSALT 

0397 VSFLAG 

0398 KEYDIS 

0399 FINE 

0400 GPRIOR 

0401 GTIA 

0402 PADDLO 

0403 STICKO 

0404 PTRIGO 

0405 STRIGO 

0406 CSTAT 

04 07 WMODE 

0408 BLIM 

0409 ; 

0410 NEWADR 

0411 TXTROW 

0412 TXTCOL 

0413 TINDEX 

0414 TXTMSC 

0415 TXTOLD 

0416 ; 

0417 TMPXl 

0418 CRETRY 

0419 SUBTMP 



$021E 
$0220 
$0222 
$0224 
$0226 
$0228 
$022A 
$022B 
$022C 
$022D 
$022E 
$022F 
$0230 
$0232 
$0233 
$0233 
$0234 
$0235 
$0236 
$0238 
$0238 
$023A 
$023C 
$023D 
$023E 
$023F 
$0240 
$0241 
$0242 
$0244 

$0245 
$0245 
$0246 
$0246 
$0247 
$026B 
$026C 
$026D 
$026E 
$026F 
$026F 
$0270 
$0278 
$027C 
$0284 
$0288 
$0289 
$028A 
$028B 
$028E 
$0290 
$0291 
$0293 
$0294 
$0296 
$0298 
$029C 
$029C 
$029E 



542 
544 
546 
548 
550 
552 
554 
555 
556 
557 
558 
559 
560 
562 
563 
563 
564 
565 
566 
568 
568 
570 
572 
573 
574 
575 
576 
577 
578 
580 

581 
581 
582 
582 
583 
619 
620 
621 
622 
623 
623 
624 
632 
636 
644 
648 
649 
650 
651 
654 
656 
657 
659 
660 
662 
664 
668 
668 
670 



DOWN TIMER 4 
DOWN TIMER 5 



DOWN TIMER 1 JSR ADDRESS 

DOWN TIMER 2 JSR ADDRESS 

DOWN TIMER 3 FLAG 

REPEAT TIMER 

DOWN TIMER 4 FLAG 

IAN' S TEMP 

DOWN TIMER FLAG 5 

DMACTL SHADOW 

DISPLAY LIST POINTER 

SKCTL SHADOW 

(800) UNLISTED 

(XL) LOADER TEMP 
LIGHT PEN HORIZONTAL 
LIGHT PEN VERTICAL 
2 SPARE BYTES 

(800) SPARE, 2 BYTES 

(XL) LOADER 

DEVICE COMMAND FRAME BUFFER 
DEVICE COMMAND AUX 1 
DEVICE COMMAND AUX 2 
TEMPORARY STORAGE 

DEVICE ERROR FLAG (EXCEPT TIMEOUT) 
FLAGS FROM DISK SECTOR 1 
NUMBER OF BOOT DISK SECTORS 
BOOT LOAD ADDRESS POINTER 
COLD START FLAG, 1 = COLD START IN 

(800) SPARE 
(XL) LOADER 

(800) DISK TIME OUT REGISTER 
(XL) RESERVED, 39 BYTES 

(800) CHARACTER LINE BUFFER, 40 BYTES 
(XL) CHARACTER SET POINTER 
(XL) FINE SCROLL TEMPORARY 
(XL) KEYBOARD DISABLE 
(XL) FINE SCROLL FLAG 
P/M PRIORITY AND GTIA MODES 

(XL) 3 MORE PADDLES, (800) 6 MORE PADDLES 
(XL) 1 MORE STICK, (800) 3 MORE STICKS 
(XL) 3 MORE PADDLE TRIGGERS, (800) 6 MORE 
(XL) 1 MORE STICK TRIGGER, (800) 3 MORE 
(800) 



5 SPARE BYTES 
(XL) LOADER RAM 



TEXT INDEX 

OLD ROW AND OLD COL FOR TEXT, 2 BYTES 
4 SPARE BYTES 

(800) 

(XL) NUMBER OF COMMAND FRAME RETRIES 
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0420 
0421 

0422 
0423 
0424 
0425 
0426 
0427 
0428 
0429 
0430 
0431 
0432 
0433 
0434 
0435 
0436 
0437 
0438 
0439 
0440 
0441 
0442 
0443 
0444 
0445 
0446 
0447 
0448 
0449 
0450 
0451 
0452 
0453 
0454 
0455 
0456 
0457 
0458 
0459 
0460 
0461 
0462 
0463 
0464 
0465 
0466 
0467 
0468 
0469 
0470 
0471 
0472 
0473 
0474 
0475 
0476 
0477 
0478 
0479 



H0LD2 
DMASK 

TMPLBT 

ESCFLG 

TABMAP 

LOGMAP 

INVFLG 

FILFLG 

TMPROW 

TMPCOL 

SCRFLG 

H0LD4 

H0LD5 

DRETRY 

SHFLOC 

BOTSCR 

PCOLRO 

COLORO 

RUN ADR 

HIUSED 

ZHIUSE 

GBYTEA 

LOAD AD 

ZLOADA 

DSCTLN 

ACMISR 

KRPDER 

KEYREP 

NOCLIK 

HELPFG 

DMASAV 

PBPNT 

PBUFSZ 

GLBABS 

RAMS I Z 

MEMTOP 

MEMLO 

HNDLOD 

DVSTAT 

CBAUDL 

CRSINH 

KEYDEL 

CHI 

CHACT 

CHBAS 

NEWROW 

NEWCOL 

ROWING 

COLING 

CHAR 

ATAGHR 

CH 

FILDAT 

DSPFLG 

SSFLAG 



$029F 
$02A0 
$02A1 
$02A2 
$02A3 
$02B2 
$02B6 
$02B7 
$02B8 
$02B9 
$02BB 
$02BG 
$02BD 
$02BD 
$02BE 
$02BF 
$02C0 
$02C4 
$02C9 
$02C9 
$02CB 
$02CD 
$02CF 
$02D1 
$02D3 
$02D5 
$02D7 
$02D9 
$02DA 
$02DB 
$02DG 
$02DD 
$02DE 
$02DF 
$02E0 
$02E4 
$02E5 
$02E7 
$02E9 
$02E9 
$02EA 
$02EE 
$02F0 
$02F1 
$02F2 
$02F3 
$02F4 
$02F5 
$02F6 
$02F8 
$02F9 
$02FA 
$02FB 
$02FG 
$02FG 
$02FE 
$02FF 



671 
672 
673 
674 
675 
690 
694 
695 
696 
697 
699 
700 
701 
701 
702 
703 
704 
708 
713 
713 
715 
717 
719 
721 
723 
725 
727 
729 
730 
731 
732 
733 
734 
735 
736 
740 
741 
743 
745 
745 
746 
750 
752 
753 
754 
755 
756 
757 
758 
760 
761 
762 
763 
764 
764 
766 
767 



15 BYTE BIT MAP FOR TAB SETTINGS 
4 BYTE LOGICAL LINE START BIT MAP 

FILL DIRING DRAW FLAG 



SCROLL FLAG 

(800) 

(XL) NUMBER OF DEVICE RETRIES 

24 NORM, 4 SPLIT 

3 MORE PLAYER COLOR REGISTERS 

4 MORE GRAPHICS COLOR REGISTERS 
(800) 23 SPARE BYTES 

(XL) LOADER VECTOR 

(XL) LOADER VECTOR 

(XL) LOADER VECTOR 

(XL) LOADER VECTOR 

(XL) LOADER VECTOR 

(XL) LOADER VECTOR 

(XL) DISK SECTOR SIZ 

(XL) RESERVED 

(XL) KEY AUTO REPEAT DELAY 

(XL) KEY AUTO REPEAT RATE 

(XL) KEY CLICK DISABLE 

(XL) HELP KEY FLAG 

(XL) SDMCTL (DMA) SAVE 

(XL) PRINTER BUFFER POINTER 

(XL) PRINTER BUFFER SIZE 
GLOBAL VARIABLES, 4 SPARE BYTES 
PERMANENT START OF ROM POINTER 
END OF FREE RAM 

(800) SPARE 

(XL) HANDLER LOADER FLAG 
DEVICE STATUS BUFFER, 4 BYTES 
CASSETTE BAUD RATE, 2 BYTES 
1 = INHIBIT CURSOR 
KEY DELAY AND RATE 



CHARACTER SET POINTER 



DRAW DESTINATION 
DRAW DESTINATION 



(XL) 
(XL) 
(XL) 
(XL) 



ATASCII CHARACTER FOR CIO 

COLOR FOR SCREEN FILL 

DISPLAY CONTROL CHARACTERS FLAG 

DISPLAY START/STOP FLAFG 



PAGE 3 
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0480 
0481 
0482 
0483 
0484 
0485 
0486 
0487 
0488 
0489 
0490 
0491 
0492 
0493 
0494 
0495 
0496 
0497 
0498 
0499 
0500 
RATE 
0501 
0502 
0503 
0504 
0505 
0506 
0507 
0508 
0509 
0510 
0511 
0512 
0513 
0514 
0515 
0516 
0517 
0518 
0519 
0520 
0521 
0522 
0523 
0524 
0525 
0526 
0527 
0528 
0529 
0530 
0531 
0532 
0533 
0534 
0535 
0536 
0537 
0538 



RESIDENT DISK HANDLER/SIO INTERFACE 



DEVICE CONTROL BLOCK 



DCB = $0300 768 

DDEVIC = $0300 768 

DUNIT = $0301 769 

DCOMND = $0302 770 

DSTATS = $0303 771 

DBUFLO = $0304 772 

DBUFHI = $0305 773 

DTIMLO = $0306 774 

DBYTLO = $0308 776 

DBYTHI = $0309 777 

DAUXl =$030A 778 

DAUX2 =$03 OB 779 

TIMERl = $030C 780 

ADDCOR = $030E 782 

JMPERS =$03 OE 782 

CASFLG = $030F 783 

TIMER2 = $0310 784 

TEMPI = $0312 786 

TEMP2 = $0313 787 

TEMP2 = $0314 788 

PTIMOT = $0314 788 

TEMP3 = $0315 789 

SAVIO =$0316 790 

TIMFLG = $0317 791 

STACKP = $0318 792 

TSTAT = $0319 793 

HATABS = $031A 794 

MAXDEV = $0321 801 

PUPBTl = $033D 829 

PUPBT2 = $033E 830 

PUPBT3 = $033F 831 

lOCB' s 

lOCB = $0340 832 

ICHID = $0340 832 

ICDNO = $0341 833 

ICCOM = $0342 834 

ICSTA = $0343 835 

ICBAL = $0344 836 

ICBAH = $0345 837 

ICPTL = $0346 838 

ICPTH = $0347 839 

ICBLL = $0348 840 

ICBLH = $0349 841 

ICAXl = $034A 842 

ICAX2 = $034B 843 

ICAX3 = $034C 844 

ICAX4 = $034D 845 

ICAX5 = $034E 846 

ICAX6 = $034F 847 

OTHER lOCB's, 112 BYTES 

PRNBUF = $03C0 960 PRINTER BUFFER, 40 BYTES 

$03E8 1000 (800) 21 SPARE BYTES 

SUPERF = $03E8 1000 (XL) SCREEN EDITOR 



INITIAL TIMER VALUE 

(800) ADDITION CORRECTION 

(XL) OPTION JUMPERS 
CASSETTE MODE WHEN SET 
FINAL VALUE, TIMERS 1 & 2 DETERMINE BAUD 



(XL) 

(800) 

(XL) PRINTER TIME OUT 

SAVE SERIAL IN DATA PORT 

TIME OUT FLAG FOR BAUD RATE CORRECTION 

SIO STACK POINTER SAVE 

TEMPORARY STATUS HOLDER 

HANDLER ADDRESS TABLE, 38 BYTES 

MAXIMUM HANDLER ADDRESS INDEX 

(XL) POWER-UP/RESET 

(XL) POWER-UP/RESET 

(XL) POWER-UP/RESET 
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0539 
0540 
0541 
0542 
0543 
0544 
0545 
0546 
0547 
0548 
0549 
0550 
0551 
0552 
0553 
0554 
0555 
0556 
0557 
0558 
0559 
0560 
0561 
0562 

0563 
0564 
0565 
0566 
0567 
0568 
0569 
0570 
0571 
0572 
0573 
0574 
0575 
0576 
0577 
0578 
0579 
0580 
0581 
0582 
0583 
0584 
0585 
0586 
0587 
0588 
0589 
0590 
0591 
0592 
0593 
0594 
0595 
0596 
0597 



CKEY = $03E9 1001 (XL) START KEY FLAG 

CASSBT = $03EA 1002 (XL) CASSETTE BOOT FLAG 

CARTCK = $03EB 1003 (XL) CARTRIDGE CHECKSUM 

ACMVAR = $03ED 1005 (XL) RESERVED, 6 BYTES 

MINTLK = $03F9 1017 (XL) RESERVED 

GINTLK = $03FA 1018 (XL) CARTRIDGE INTERLOCK 

CHLINK = $03FB 1019 (XL) HANDLER CHAIN, 2 BYTES 

CASBUF = $03FD 1021 CASSETTE BUFFER, 131 BYTES TO $047F 



PAGE 4 

USAREA = $0480 1152 128 SPARE BYTES 

SEE APPENDIX C FOR PAGES 4 AND 5 USAGE 

PAGE 5 

PAGE5 = $0500 1280 127 FREE BYTES 

$057E 1406 129 FREE BYTES IF FLOATING POINT ROUTINES 
NOT USED 

FLOATING POINT NON-ZERO PAGE RAM, NEEDED ONLY IF FP IS USED 



LBPRl 

LBPR2 

LBUFF 

PLYARG 

FPSCR 

FPSCRl 

FSCR 

FSCRl 

LBFEND 



$057E 1406 LBUFF PREFIX 1 

$05FE 1534 LBUFF PREFIX 2 

$0580 1408 LINE BUFFER 

$05E0 1504 POLYNOMIAL ARGUMENTS 

$05E6 1510 PLYARG+FPREC 

$05EC 1516 FPSCR+FPREC 

$05E6 1510 =FPSCR 

$05EC 1516 =FPSCR1 

$05FF 1535 END OF LBUFF 
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$0600 



1536 256 FREE BYTES 
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BOOTRG 



$0700 



17 92 PROGRAM AREA 



RITCAR 
LFTCAR 
COPAGE 
COPAGE 

CH0RG2 



UPPER ADDRESSES 



$8000 32768 RAM IF NO CARTRIDGE 

$A0 00 4 960 RAM IF NO CARTRIDGE 

$C000 49152 (800) EMPTY, 4K BYTES 

$C000 49152 (XL) 2K FREE RAM IF NO CARTRIDGE 

$C800 51200 (XL) START OF OS ROM 

$CC00 52224 (XL) INTERNATIONAL CHARACTER SET 
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0598 
0599 
0600 
0601 
0602 
0603 
0604 
0605 
0606 
0607 
0608 
0609 
0610 
0611 
0612 
0613 
0614 
0615 
0616 
0617 
0618 
0619 
0620 
0621 
0622 
0623 
0624 
0625 
0626 
0627 
0628 
0629 
0630 
0631 
0632 
0633 
0634 
0635 
0636 
0637 
0638 
0639 
0640 
0641 
0642 
0643 
0644 
0645 
0646 
0647 
0648 
0649 
0650 
0651 
0652 
0653 
0654 
0655 
0656 
0657 



HARDWARE REGISTERS 



SEE REGISTER LIST FOR MORE INFORMATION 



HPOSPO 

MOPF 

SIZEPO 

MOPL 

SIZEM 

GRAFPO 

GRAFM 

COLPMO 

COLPFO 

PRIOR 

GTIAR 

VDELAY 

GRACTL 

HITCLR 

CONSOL 

AUDFl 

AUDCl 

AUDCTL 

RANDOM 

IRQEN 

SKCTL 

PORTA 

PORTB 

PACTL 

PBCTL 

DMACLT 

DLISTL 

HSCROL 

VSCROL 

CHBASE 

WSYNC 

VCOUNT 

NMIEN 



$D000 
$D000 
$D008 
$D008 
$D00C 
$D00D 
$D011 
$D012 
$D016 
$D01B 
$D01B 
$D01C 
$D01D 
$D01E 
$D01F 
$D200 
$D201 
$D208 
$D20A 
$D20E 
$D20F 
$D300 
$D301 
$D302 
$D303 
$D400 
$D402 
$D404 
$D405 
$D409 
$D40A 
$D40B 
$D40E 



53248 
53248 
53256 
53256 
53260 
53261 
53265 
53266 
53270 
53275 
53275 
53276 
53277 
53278 
53279 
53760 
53751 
53758 
53770 
53774 
53775 
54016 
54017 
54018 
54019 
54272 
54274 
54276 
54277 
54281 
54282 
54283 
54286 



FLOATING POINT MATH ROUTINES 



AFP 

FASC 

IFP 

FPI 

ZERO 

ZFl 

FSUB 

FADD 

FMUL 

FDIV 

PLYEVL 

FLDOR 

FLDOP 

FLDIR 

FLDIP 

FSTOR 



$D800 
$D8E5 
$D9AA 
$D9D2 
$DA4 4 
$DA4 5 
$DA60 
$DA65 
$DADB 
$DB28 
$DD40 
$DD89 
$DD8D 
$DD98 
$DD9C 
$DDA7 



55296 
55526 
55722 
55752 
55876 
55878 
55904 
55910 
55027 
55104 
55640 
55713 
55717 
55728 
55732 
55743 
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0658 
0659 
0660 
0661 
0662 
0663 
0664 
0665 
0666 
0667 
0668 
0669 
0670 
0671 
0672 
0673 
0674 
0675 
0676 
0677 
0678 
0679 
0680 
0681 
0682 
0683 
0684 
0685 
0686 
0687 
0688 
0689 
0690 
0691 
0692 
0693 
0694 
0695 
0696 
0697 
0698 
0699 
0700 



FSTOP 

FMOVE 

EXP 

EXP 10 

LOG 

LOGIO 



$DDAB 
$DDB6 
$DDCO 
$DDCC 
$DECD 
$DED1 



56747 
56758 
56768 
56780 
57037 
57041 



OPERATING SYSTEM 



MODULE ORIGIN TABLE 

CHORG = $E000 57344 CHARACTER SET, IK 

VECTBL = $E400 58368 VECTOR TABLE 

VCTABL = $E480 58496 RAM VECTOR INITIAL VALUE TABLE 

CIOORG = $E4A6 58534 CIO HANDLER 

INTORG = $E6D5 59093 INTERRUPT HANDLER 

SIOORG = $E944 59716 SIO DRIVER 

DSKORT = $EDEA 60 90 6 DISK HANDLER 

PRNORG = $EE78 61048 PRINTER HANDLER 

CASORG = $EE78 61048 CASSETTE HANDLER 

MONORG = $F0E3 61667 MONITOR/POWER UP MODULE 

KBDORG = $F3E4 62436 KEYBOARD/DISPLAY HANDLER 



VECTOR TABLE, CONTAINS ADDRESSES OF CIO ROUTINES IN THE 
FOLLOWING ORDER. THE ADDRESSES IN THE TABLE ARE TRUE ADDRESSES-1 



ADDRESS + 

+ 2 

+ 4 

+ 6 

+ 8 

+ A 

+ C 

+ F 



EDITRV = $E400 

SCRENV = $E410 

KEYBDV = $E420 

PRINTV = $E430 



OPEN 

CLOSE 

GET 

PUT 

STATUS 

SPECIAL 

JMP TO INITIALIZATION 

NOT USED 



58368 EDITOR 

58384 SCREEN 

584 KEYBOARD 

58416 PRINTER 
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Go to appendix A 
Go to appendix C 



APPENDIX C 

Memory Use 



PageO 

$00-$7F 

Operating system zero-page. The entire first half of page zero is reserved for the operating 
system. 

$80-$FF 

Free zero-page. The top half of page zero is free if BASIC is disabled. BASIC uses all but 
$CB-$D1 . The floating point math routines use $D4-$FF. If the floating point arithmetic 
package is not used this memory is free. 

Page 1 

$100-1 FF 

This is the 6502 stack. The stack pointer initialized to $1 FF and moves downward as the 
stack is filled. 

Pages 2-5 

$200-$47F 

This area is used for operating system database variables. Parts which are not used in some 
particular programs, such as the cassette buffer or printer buffer, may then be used for other 
purposes. See the O.S. equate listing for these locations. 

$480-$57D ($480-$6FF if no floating point) 

This is called the user work space. It is free to be used by programs. If the floating point 
arithmetic package is not used the user work space extends to $6FF. This area is used by 
BASIC. 

$57E-$5FF 
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This area is used by the floating point arithmetic package. It is free if the package is not 
used. 

Pages 

$600-6FF 

Atari has solemnly sworn never to put anything in this page of memory. 

Page 7-the screen region 

$700 

This is called the boot region. Most machine language programs which don't use DOS load 
at this address. DOS extends from $700-$1CFB. 

MEMLO 

The address pointed to by the O.S. database variable MEMLO [$02E7,2 (743)] is the first 
byte of free memory. This pointer is usually changed by any program's initialization routine. 
For example, upon power-up, MEMLO points to $700. When DOS loads in, DOS changes 
MEMLO to point to $2A80. If an AUTORUN.SYS program then loads in just above DOS, 
such as DISKIO, it will usually change MEMLO to point above itself. One important reason 
for this is to protect the program from BASIC. BASIC uses memory starting at MEMLO. 

MEMTOP 

MEMTOP [$2E5,2 (741)] is set by the O.S. whenever a graphics mode is entered. The 
graphics region is at the very top of ram and extends downward. The address MEMTOP 
points to depends on how much memory the screen region uses. 

APPMHI 

APPMHI [$0E,2 (14)] should be set by any program to point to the highest address required 
by the program. If the O.S. cannot set up a screen without going below APPMHI it will return 
a not-enough-memory-for-screen-mode error. 

The cartridge slots 

$8000 (32768) 

This is the beginning of the 8K bytes used by the right cartridge slot of the 800. This is also 
where 16K cartridges begin. If there is no cartridge here it is ram. 

$A000 (40960) 

This is the beginning of the left cartridge of the 800 or the only cartridge slot on all other 
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models. This is where the BASIC ROM resides in the XL/XE models. This area is RAM is 
there is no cartridge or BASIC is disabled on XL/XE models. 

above the cartridges 

$COOO-$CFFF (49152-53247) 

This area is empty on the 800. Sometimes special ROM chips, such as Omnimon are wired 
in here. On the XL/XE models $C000-C7FF is free ram if there are no cartridges. On XL/XE 
models, the O.S. ROM starts at $C800 

$D000-$D7FF (53248-57373) 

This area is taken up by the hardware chips. The chips actually take only a fraction of this 
space. If these addresses are further decoded there is space for many, many more hardware 
chips. For example. The PIA chip uses 256 bytes of memory but needs only 4 bytes. There 
is room for 64 PIA chips in this reserved memory. 

$E000-E3FF (57344-58367) 

This is the location of the ATASCII character set. 

$E400-FFF7 (58368-65527) 

This is the operating system ROM 

$FFF8-$FFFF (65528-65535) 

These last 8 bytes contain the addresses of the interrupt vectors. Upon power up the 6502 
gets a reset pulse and looks up the reset routine here. 

Go to appendix B 
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